Account

Represents an individual account, which is an organization or person involved with your business (such as customers, competitors, and partners).

Supported Calls

create(), update(), delete(), query(), search(), retrieve(), getDeleted(), getUpdated(), describeSObjects(), merge(), upsert()

Special Access Rules

Customer Portal users can access their own accounts and any account shared with them.

Fields

Field Name	Field Type	Field Properties	Description
AccountNumber	string	Create Filter Nillable Update	Account number assigned to this account (not the unique, system-generated ID assigned by Salesforce during creation). Maximum size is 40 characters.
AnnualRevenue	currency	Create Filter Nillable Update	Estimated annual revenue of the account.
BillingCity BillingCountry BillingPostalCode BillingState	string	Create Filter Nillable Update	Details for the billing address of this account. Maximum size for city and country is 40 characters, maximum size for postal code and state is 20 characters.
BillingStreet	textarea	Filter Nillable Update	Street address for the billing address of this account.
ConnectionReceivedID	reference	Filter Nillable	ID of the PartnerNetworkConnection that shared this record with your organization. This field is only available if you have enabled Salesforce to Salesforce.
ConnectionSentID	reference	Filter Nillable	ID of the PartnerNetworkConnection that you shared this record with. This field is only available if you have enabled Salesforce to Salesforce.
Description	textarea	Create Filter Nillable Retrieve Update	Text description of the account. Limited to 32,000 KB.
Fax	phone	Create Filter Nillable Update	Fax number for the account.
Industry	picklist	Create Filter Nillable Update	An industry associated with this account.
IsCustomerPortal	boolean	Defaulted on create Filter	Indicates whether the account has at least one contact enabled to use the organization's Customer portal (true) or not (false). This field is not available until at least on Customer portal has been defined.
IsDeleted	boolean	Defaulted on create Filter	Indicates whether the object has been moved to the Recycle Bin (`true`) or not (`false`). Label is Deleted.
IsPartner	boolean	Defaulted on create Filter	Indicates whether the account has at least one contact enabled to use the organization's PRM Portal (true) or not (false). This field is not available until at least on PRM Portal has been defined.
IsPersonAccount	boolean	Defaulted on create Filter	Read only. Label is Is Person Account. Indicates whether this account has a record type of Person Account (`true`) or not (`false`). For more information about person accounts, see Person Account Record Types, and the Salesforce online help.
LastActivityDate	date	Nillable	Value is one of the following, whichever is the most recent: Due date of the most recent event logged against the record. Due date of the most recently closed task associated with the record.
MasterRecordId	reference	Filter Nillable	If this object was deleted as the result of a merge, this field contains the ID of the record that was kept. If this object was deleted for any other reason, or has not been deleted, the value is `null`.
Name	string	Create Filter Update	Required. Label is Account Name. Name of the account. Maximum size is 255 characters. If the account has a record type of Person Account: This value is the concatenation of the FirstName and LastName of the associated person contact. You cannot modify this value.
NumberOfEmployees	int	Create Filter Nillable Update	Label is Employees. Number of employees working at the company represented by this account. Maximum size is eight digits.
OwnerId	reference	Create Defaulted on create Filter Update	The ID of the user who currently owns this account. Default value is the user logged in to the API to perform the create. If you have set up account teams in your organization, updating this field has different consequences depending on your version of the API:. For API version 12.0 and later, sharing records are kept, as they are for all objects. For API version before 12.0, sharing records are deleted.
Ownership	picklist	Create Filter Nillable Update	Ownership type for the account, for example Private, Public, or Subsidiary.
ParentId	reference	Create Filter Nillable Update	ID of the parent object, if any.
Phone	phone	Create Filter Nillable Update	Phone number for this account. Maximum size is 40 characters.
Rating	picklist	Create Filter Nillable Update	The account’s prospect rating, for example Hot, Warm, or Cold.
RecordTypeId	reference	Create Filter Nillable Update	ID of the record type assigned to this object.
Salutation	picklist	Create Filter Nillable Update	Honorific added to the name for use in letters, etc.
ShippingCity ShippingCountry ShippingPostalCode ShippingState	string	Create Filter Nillable Update	Details of the shipping address for this account. City and country maximum size is 40 characters each, postal code and state maximum size is 20 characters each.
ShippingStreet	textarea	Create Filter Nillable Update	The street address of the shipping address for this account. Maximum of 255 characters.
Sic	string	Create Filter Nillable Update	Standard Industrial Classification code of the company’s main business categorization, for example, 57340 for Electronics. Maximum of 20 characters.
Site	string	Create Filter Nillable Update	Name of the account’s location, for example Headquarters or London. Label is Account Site. Maximum of 80 characters.
TickerSymbol	string	Create Filter Nillable Update	The stock market symbol for this account. Maximum of 20 characters.
Type	picklist	Create Filter Nillable Update	Type of account, for example, Customer, Competitor, or Partner.
Website	url	Create Filter Nillable Update	The website of this account. Maximum of 255 characters.

IsPersonAccount Fields

These fields are the subset of person account fields that are contained in the child person contact record of each person account. If the IsPersonAccount field has the value false, the following fields have a null value and cannot be modified. If true, the fields contain the value indicated in the Description column in the following table and can be modified. For more information, see "Person Account Fields" in the Salesforce online help.

Field Name	Field Type	Field Properties	Description
FirstName	string	Create Filter Nillable Update	First name of the person for a person account. Maximum size is 40 characters.
LastName	string	Create Filter Nillable Update	Last name of the person for a person account. Required if the record type is a person account record type. For more information about person accounts, see the Salesforce online help and Person Account Record Types. Maximum size is 80 characters.
PersonAssistantName	string	Create Filter Nillable Update	The person account’s assistant name. Label is Assistant. Maximum size is 40 characters.
PersonAssistantPhone	phone	Create Filter Nillable Update	The person account’s assistant phone. Label is Asst. Phone. Maximum size is 40 characters.
PersonBirthDate	date	Create Filter Nillable Update	The assistant name. Label is Birthdate.
PersonContactId	reference	Filter Nillable Update	The ID for the contact associated with this person account. Label is Contact ID.
PersonDepartment	string	Create Filter Nillable Update	The department. Label is Department. Maximum size is 80 characters.
PersonEmail	email	Create Filter Nillable Update	The person account’s email. Label is Email.
PersonEmailBouncedDate	dateTime	Create Filter Nillable Update	If bounce management is activated and an email sent to the person account bounces, the date and time the bounce occurred.
PersonEmailBouncedReason	string	Create Filter Nillable Update	If bounce management is activated and an email sent to the person account bounces, the reason the bounce occurred.
PersonHasOptedOutOfEmail	boolean	Create Defaulted on create Filter Update	Indicates whether the person account has opted out of email (`true`) or not (`false`). Label is Email Opt Out.
PersonHomePhone	phone	Create Filter Nillable Update	The person account’s home phone. Label is Home Phone.
PersonLastCURequestDate	dateTime	Create Filter Nillable Update	The last date that the person account was requested. Label is Last Stay-in-Touch Request Date.
PersonLastCUUpdateDate	dateTime	Create Filter Nillable Update	The last date a person account was updated. Label is Last Stay-in-Touch Save Date.
PersonLeadSource	picklist	Create Filter Nillable Update	The person account’s lead source. Label is Lead Source.
PersonMailingCity PersonMailingCountry PersonMailingPostalCode PersonMailingState	string	Create Filter Nillable Update	Details about the person account’s mailing city. Labels are Mailing City, Mailing Country, Postal Code, and State. Maximum size for city and country is 40 characters. Maximum size for postal code and state is 20 characters.
PersonMailingStreet	textarea	Create Filter Nillable Update	The person account’s mailing street address. Label is Mailing Street. Maximum size is 255 characters.
PersonMobilePhone	phone	Create Filter Nillable Update	The person account’s mobile phone number. Label is Mobile.
PersonOtherCity PersonOtherCountry PersonOtherPostalCode PersonOtherState	string	Create Filter Nillable Update	Details about the person account’s alternate address. Labels are Other City, Other Country, Other Zip/Postal Code, and Other State.
PersonOtherPhone	phone	Create Filter Nillable Update	The person account’s alternate phone. Label is Other Phone.
PersonOtherStreet	textarea	Create Filter Nillable Update	The person account’s alternate street address. Label is Other Street.
PersonTitle	string	Create Filter Nillable Update	The person account’s title. Label is Title. Maximum size is 80 characters.

Note

If you are importing Account data into Salesforce and need to set the value for an audit field, such as CreatedDate, contact salesforce.com. Audit fields are automatically updated during API operations unless you request to set these fields yourself. For more information, see System Fields.

Usage

Use this object to query and manage accounts in your organization. Client applications can create(), update(), delete(), and query()Attachments associated with an account via the API.

Client applications can also create or update account objects by converting a Lead via the convertLead() call. For more information, see convertLead().

If the values in the IsPersonAccount Fields are not null, you cannot change IsPersonAccount to false, or an error will occur. For more information about person accounts, see Person Account Record Types, and the Salesforce online help.