v1

latestOpenAPI 3.1.02026-07-247601.0 MB

Accounts

Update an Account

This endpoint doesn't consume Apollo credits. Learn more about API pricing and credits.

An <a href="https://knowledge.apollo.io/hc/en-us/articles/5995865049229-View-and-Edit-Accounts" target="_blank">account</a> is a company saved in Apollo. Use the Update an Account endpoint to update existing accounts in your team's Apollo account. To create a new account, use the <a href="https://docs.apollo.io/reference/create-an-account">Create an Account endpoint</a> instead. To update the account stage for multiple accounts, use the <a href="https://docs.apollo.io/reference/bulk-update-accounts">Bulk Update Accounts endpoint</a>. This endpoint requires a master API key. If you call the endpoint without a master key, you receive a 403 response. Check out <a href="https://docs.apollo.io/docs/create-api-key">Create an API Key</a> to learn how to create a master key.

patch/accounts/{account_id}

Path parameters

account_idstring required

The Apollo ID for the account that you want to update. To find account IDs, call the <a href="https://docs.apollo.io/reference/search-for-accounts" target="_blank">Search for Accounts endpoint</a> and identify the id value for the contact. Example: 66e9abf95ac32901b20d1a0d

Request body

namestring

Update the account's name. This should be a human-readable name. Example: The Fast Irish Copywriters

domainstring

Update the domain name for the account. Do not include www. or similar. Example: apollo.io or microsoft.com

owner_idstring

The ID for the account owner within your team's Apollo account. Enter a different ID to update the owner of the account. Use the <a href="https://docs.apollo.io/reference/get-a-list-of-users" target="_blank">Get a List of Users endpoint</a> to retrieve IDs for all of the users within your Apollo account. Example: 66302798d03b9601c7934ebf

account_stage_idstring

The Apollo ID for the account stage to which you want to assign the account. Enter a different ID to update the account stage. Call the <a href="https://docs.apollo.io/reference/list-account-stages" target="_blank">List Account Stages endpoint</a> to retrieve a list of all the account stage IDs available in your Apollo account. If you do not specify the account stage, Apollo automatically assigns the account to a stage as determined by your team's Apollo account. To change the order of account stages, launch the Apollo product and go to Settings > Objects > <a href="https://app.apollo.io/#/settings/accounts/stages" target="_blank">Accounts</a>. Then, access the Triggers tab and change the stage for when an account is created. Example: 61b8e913e0f4d2012e3af74e

raw_addressstring

Update the corporate location for the account. This can include a city, US state, and country. Apollo matches the location you provide to the most applicable pre-defined location. Examples: Belfield, Dublin 4, Ireland; Dallas, United States

phonestring

Update the primary phone number for the account. This can be the phone number for the corporate headquarters, a branch location, or a direct dial to the primary point of contact for the account. Apollo sanitizes phone numbers, so you can enter them in any format. The sanitized number can be viewed in the endpoint response. Examples: 555-555-0133; +44 7700 900852

typed_custom_fieldsobject

Add information to <a href="https://knowledge.apollo.io/hc/en-us/articles/4412498754445-Create-Custom-Account-Fields" target="_blank">custom fields</a> in Apollo. Your custom fields are unique to your team's Apollo account. This means that the examples in this documentation may not work for your testing purposes. To utilize this parameter successfully, call the <a href="https://docs.apollo.io/reference/get-a-list-of-all-custom-fields">Get a List of All Custom Fields</a> endpoint and identify the id value for the custom field, as well as the appropriate data type. For example, if a custom field accepts picklist entries, you need to pass the accompanying id value for the picklist entry that you want to use as the input value. Example: When the <a href="https://docs.apollo.io/reference/get-a-list-of-all-custom-fields">Get a List of All Custom Fields</a> endpoint returns an id of field:

"60c39ed82bd02f01154c470a" (datetime)

then the value passed should be:

{"60c39ed82bd02f01154c470a": "2025-08-07"}

Example request

{
  "typed_custom_fields": {
    "60c39ed82bd02f01154c470a": "2025-08-07"
  }
}

Response

200

Example response

{
  "account": {
    "id": "66e9abf95ac32901b20d1a0d",
    "domain": "irishcopywriters.com",
    "name": "The Fast Irish Copywriters",
    "team_id": "6095a710bd01d100a506d4ac",
    "account_stage_id": "61b8e913e0f4d2012e3af74e",
    "source": "api",
    "original_source": "api",
    "owner_id": "66302798d03b9601c7934ebf",
    "created_at": "2024-09-17T16:19:05.663Z",
    "phone": "555-555-0172",
    "phone_status": "no_status",
    "sanitized_phone": "+15555550172",
    "existence_level": "full",
    "modality": "account",
    "source_display_name": "Created from API"
  }
}