---
title: "Create an Account"
method: POST
path: "/accounts"
tags: ["Accounts"]
---

# Create an Account

`POST /accounts`

This endpoint doesn't consume Apollo credits. Learn more about [API pricing and credits](https://docs.apollo.io/docs/api-pricing).

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.<br><br>Use the Create an Account endpoint to add a new account to your team's Apollo account.<br><br>Apollo doesn't apply deduplication processes when you create a new account via the API. If your entry has the same name, domain, or other details as an existing account, Apollo creates a new account instead of updating the existing account. To update an existing account, use the <a href="https://docs.apollo.io/reference/update-an-account">Update an Account endpoint</a> instead.<br><br>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.

## Request body

- object
  - `name` string — Name the account that you are creating. This should be a human-readable name. <br><br>Example: `The Irish Copywriters`
  - `domain` string — The domain name for the account. <br><br>Do not include `www.` or similar. <br><br>Example: `apollo.io` or `microsoft.com`
  - `owner_id` string — The ID for the account owner within your team's Apollo account. <br><br>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. <br><br>Example: `66302798d03b9601c7934ebf`
  - `account_stage_id` string — The Apollo ID for the account stage to which you want to assign the account. 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. <br><br>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 <b>Settings</b> > <b>Objects</b> > <a href="https://app.apollo.io/#/settings/accounts/stages" target="_blank"><b>Accounts</b></a>. Then, access the <b>Triggers</b> tab and change the stage for when an account is created.<br><br>Example: `6095a710bd01d100a506d4b9`
  - `phone` string — The primary phone number for the account. <br><br>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. <br><br>Apollo sanitizes phone numbers, so you can enter them in any format. The sanitized number can be viewed in the endpoint response. <br><br>Examples: `555-555-0133`; `+44 7700 900852`
  - `raw_address` string — The corporate location for the account. This can include a city, US state, and country. <br><br>Apollo matches the location you provide to the most applicable pre-defined location. <br><br>Examples: `Belfield, Dublin 4, Ireland`; `Dallas, United States`
  - `typed_custom_fields` object — 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. <br><br><b>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.</b> <br><br>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. <br><br><b>Example</b>: 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"}`

## Response `200`

200

- object
  - `account` object
    - `id` string
    - `domain` string
    - `name` string
    - `team_id` string
    - `organization_id` unknown
    - `account_stage_id` string
    - `source` string
    - `original_source` string
    - `creator_id` unknown
    - `owner_id` string
    - `created_at` string
    - `phone` string
    - `phone_status` string
    - `hubspot_id` unknown
    - `salesforce_id` unknown
    - `crm_owner_id` unknown
    - `parent_account_id` unknown
    - `linkedin_url` unknown
    - `sanitized_phone` string
    - `account_playbook_statuses` unknown[]
      - unknown
    - `account_rule_config_statuses` unknown[]
      - unknown
    - `existence_level` string
    - `label_ids` unknown[]
      - unknown
    - `typed_custom_fields` object
    - `custom_field_errors` object
    - `modality` string
    - `source_display_name` string
    - `crm_record_url` unknown
    - `intent_strength` unknown
    - `show_intent` boolean
    - `has_intent_signal_account` boolean
    - `intent_signal_account` unknown

## Other responses

- `401` — 401
- `403` — 403
- `422` — 422
- `429` — 429

---

[API](https://skmtc.dev/apollo/apis/apollo-rest-api.md) · [All operations](https://skmtc.dev/apollo/apis/apollo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apollo/apollo-rest-api/revisions/c715a05fa6e2/schema)