v1

latestOpenAPI 3.1.02026-07-247601.0 MB

Accounts

Update Account Owner for Multiple Accounts

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

<a href="https://knowledge.apollo.io/hc/en-us/articles/5631686093069-Edit-a-Contact-or-Account-Owner" target="_blank">Account owners</a> manage saved accounts in Apollo. Use the Update Account Owner for Multiple Accounts endpoint to assign multiple accounts to a different user in your team's Apollo account. To update more than the account owner, such as domains or phone numbers, use the <a href="https://docs.apollo.io/reference/update-an-account">Update an Account endpoint</a> instead. 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" target="_blank">Create an API Key</a> to learn how to create a master key.

post/accounts/update_owners

Query parameters

account_ids[]string[] required

The Apollo IDs for the account that you want to assign to an owner. 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 account. Example: 66e9abf95ac32901b20d1a0d

owner_idstring required

The ID for the account owner within your team's Apollo account. This user will be assigned ownership of the accounts. 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

Response

200

Example response

{
  "accounts": [
    {
      "id": "66e9a4db056fe802d331fb8a",
      "owner_id": "66302798d03b9601c7934ebf"
    }
  ]
}