Legacy schema — superseded by the Accounts API. New programs integrate via the Accounts API. This schema remains the supported path for file-integrated programs that have not yet migrated.
Overview
Accounts contain a Status and Status Reason, which pair together to define its state.Statuses
| Status | Description | Reason |
|---|---|---|
active | Indicates that the account is fully functional and operates as expected. | active |
inactive | Indicates that the client has taken action to restrict activity on the account. Lead does not run additional validations on inactive accounts during daily reporting. However, clients are expected to take action on inactive accounts according to their policies. | dormantfrozenother |
closed | Represents a terminal state for the account, meaning it is no longer active. A closed account cannot be re-opened and Lead’s system will reject any additional changes or activity reported once it is reported in a closed status. If there is a chance that activity may still occur on the Account, use the inactive status until it is confirmed that no further activity will occur. | entity_closedclient_closedpaid_offcharged_offcanceled |