> This page is for Unified. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. The `Account` object is used to represent a company in a CRM system. ### The Account Object ```json { "id": "string", "remote_id": "string", "created_at": "2023-01-01T00:00:00Z", "modified_at": "2023-01-01T00:00:00Z", "owner": "string", "name": "string", "description": "string", "industry": "string", "website": "string", "number_of_employees": 0, "addresses": [ { "created_at": "2023-01-01T00:00:00Z", "modified_at": "2023-01-01T00:00:00Z", "street_1": "string", "street_2": "string", "city": "string", "state": "string", "postal_code": "string", "country": "AF", "address_type": "BILLING" } ], "phone_numbers": [ { "created_at": "2023-01-01T00:00:00Z", "modified_at": "2023-01-01T00:00:00Z", "phone_number": "string", "phone_number_type": "string" } ], "last_activity_at": "2023-01-01T00:00:00Z", "remote_updated_at": "2023-01-01T00:00:00Z", "remote_created_at": "2023-01-01T00:00:00Z", "account_url": "string", "remote_was_deleted": true, "field_mappings": { "organization_defined_targets": { "string": {} }, "linked_account_defined_targets": { "string": {} } }, "remote_data": [ { "path": "string", "data": {} } ], "remote_fields": [ { "remote_field_class": { "id": "string", "display_name": "string", "remote_key_name": "string", "description": "string", "is_custom": true, "is_common_model_field": true, "is_required": true, "field_type": "string", "field_format": "string", "field_choices": [ "string" ], "item_schema": { "item_type": "string", "item_format": "string", "item_choices": [ "string" ] } }, "value": { "string": {} } } ] } ``` ### Schema (`Account`) ```yaml components: schemas: CountryEnum: type: string enum: - AF - AX - AL - DZ - AS - AD - AO - AI - AQ - AG - AR - AM - AW - AU - AT - AZ - BS - BH - BD - BB - BY - BE - BZ - BJ - BM - BT - BO - BQ - BA - BW - BV - BR - IO - BN - BG - BF - BI - CV - KH - CM - CA - KY - CF - TD - CL - CN - CX - CC - CO - KM - CG - CD - CK - CR - CI - HR - CU - CW - CY - CZ - DK - DJ - DM - DO - EC - EG - SV - GQ - ER - EE - SZ - ET - FK - FO - FJ - FI - FR - GF - PF - TF - GA - GM - GE - DE - GH - GI - GR - GL - GD - GP - GU - GT - GG - GN - GW - GY - HT - HM - VA - HN - HK - HU - IS - IN - ID - IR - IQ - IE - IM - IL - IT - JM - JP - JE - JO - KZ - KE - KI - KW - KG - LA - LV - LB - LS - LR - LY - LI - LT - LU - MO - MG - MW - MY - MV - ML - MT - MH - MQ - MR - MU - YT - MX - FM - MD - MC - MN - ME - MS - MA - MZ - MM - NA - NR - NP - NL - NC - NZ - NI - NE - NG - NU - NF - KP - MK - MP - 'NO' - OM - PK - PW - PS - PA - PG - PY - PE - PH - PN - PL - PT - PR - QA - RE - RO - RU - RW - BL - SH - KN - LC - MF - PM - VC - WS - SM - ST - SA - SN - RS - SC - SL - SG - SX - SK - SI - SB - SO - ZA - GS - KR - SS - ES - LK - SD - SR - SJ - SE - CH - SY - TW - TJ - TZ - TH - TL - TG - TK - TO - TT - TN - TR - TM - TC - TV - UG - UA - AE - GB - UM - US - UY - UZ - VU - VE - VN - VG - VI - WF - EH - YE - ZM - ZW description: The country code in ISO 3166-1 alpha-2 format. title: CountryEnum AddressTypeEnum: type: string enum: - BILLING - SHIPPING title: AddressTypeEnum Address: type: object properties: created_at: type: string format: date-time description: The datetime that this object was created by Merge. modified_at: type: string format: date-time description: The datetime that this object was modified by Merge. street_1: type: - string - 'null' description: Line 1 of the address's street. street_2: type: - string - 'null' description: Line 2 of the address's street. city: type: - string - 'null' description: The address's city. state: type: - string - 'null' description: The address's state. postal_code: type: - string - 'null' description: The address's postal code. country: oneOf: - $ref: '#/components/schemas/CountryEnum' - type: 'null' description: >- The address's country. The country code in ISO 3166-1 alpha-2 format. address_type: oneOf: - $ref: '#/components/schemas/AddressTypeEnum' - type: 'null' description: The address type. description: |- # The Address Object ### Description The `Address` object is used to represent an entity's address. ### Usage Example TODO title: Address PhoneNumber: type: object properties: created_at: type: string format: date-time description: The datetime that this object was created by Merge. modified_at: type: string format: date-time description: The datetime that this object was modified by Merge. phone_number: type: - string - 'null' description: The phone number. phone_number_type: type: - string - 'null' description: The phone number's type. description: |- # The PhoneNumber Object ### Description The `PhoneNumber` object is used to represent an entity's phone number. ### Usage Example Fetch from the `GET Contact` endpoint and view their phone numbers. title: PhoneNumber AccountFieldMappings: type: object properties: organization_defined_targets: type: object additionalProperties: description: Any type linked_account_defined_targets: type: object additionalProperties: description: Any type title: AccountFieldMappings RemoteData: type: object properties: path: type: string description: The third-party API path that is being called. data: description: >- The data returned from the third-party for this object in its original, unnormalized format. required: - path description: >- # The RemoteData Object ### Description The `RemoteData` object is used to represent the full data pulled from the third-party API for an object. ### Usage Example TODO title: RemoteData FieldTypeEnum: type: string enum: - string - number - date - datetime - bool - list title: FieldTypeEnum FieldFormatEnum: type: string enum: - string - number - date - datetime - bool - list title: FieldFormatEnum ItemTypeEnum: type: string enum: - string - number - date - datetime - bool - list title: ItemTypeEnum ItemFormatEnum: type: string enum: - string - number - date - datetime - bool - list title: ItemFormatEnum ItemSchema: type: object properties: item_type: $ref: '#/components/schemas/ItemTypeEnum' item_format: $ref: '#/components/schemas/ItemFormatEnum' item_choices: type: array items: type: string title: ItemSchema RemoteFieldClass: type: object properties: id: type: string display_name: type: string remote_key_name: type: string description: type: string is_custom: type: boolean is_common_model_field: type: boolean is_required: type: boolean field_type: $ref: '#/components/schemas/FieldTypeEnum' field_format: $ref: '#/components/schemas/FieldFormatEnum' field_choices: type: array items: type: string item_schema: $ref: '#/components/schemas/ItemSchema' title: RemoteFieldClass RemoteField: type: object properties: remote_field_class: $ref: '#/components/schemas/RemoteFieldClass' value: type: object additionalProperties: description: Any type required: - remote_field_class title: RemoteField Account: type: object properties: id: type: string format: uuid remote_id: type: - string - 'null' description: The third-party API ID of the matching object. created_at: type: string format: date-time description: The datetime that this object was created by Merge. modified_at: type: string format: date-time description: The datetime that this object was modified by Merge. owner: type: - string - 'null' format: uuid description: The account's owner. name: type: - string - 'null' description: The account's name. description: type: - string - 'null' description: The account's description. industry: type: - string - 'null' description: The account's industry. website: type: - string - 'null' format: uri maxLength: 2000 description: The account's website. number_of_employees: type: - integer - 'null' minimum: -2147483648 maximum: 2147483647 description: The account's number of employees. addresses: type: array items: $ref: '#/components/schemas/Address' phone_numbers: type: array items: $ref: '#/components/schemas/PhoneNumber' last_activity_at: type: - string - 'null' format: date-time description: >- The last date (either most recent or furthest in the future) of when an activity occurs in an account. remote_updated_at: type: - string - 'null' format: date-time description: >- When the CRM system account data was last modified by a user with a login. remote_created_at: type: - string - 'null' format: date-time description: When the third party's account was created. account_url: type: - string - 'null' format: uri maxLength: 2000 description: The account's URL in the remote system. remote_was_deleted: type: boolean description: >- Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. [Learn more](https://docs.merge.dev/integrations/hris/supported-features/). field_mappings: oneOf: - $ref: '#/components/schemas/AccountFieldMappings' - type: 'null' remote_data: type: - array - 'null' items: $ref: '#/components/schemas/RemoteData' remote_fields: type: array items: $ref: '#/components/schemas/RemoteField' title: Account ```