v1

latestOpenAPI 3.1.02026-07-247601.0 MB

Accounts

Bulk Create Accounts

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 bulk create accounts endpoint to create up to one hundred accounts in a single API request. This endpoint supports intelligent deduplication and returns separate arrays for newly created and existing accounts. Important: This endpoint creates new accounts but doesn't update existing ones. Existing accounts that match the criteria are returned in the <code>existing_accounts</code> array without modification. To update existing accounts, use the <a href="https://docs.apollo.io/reference/bulk-update-accounts">Bulk Update Accounts endpoint</a>.

post/accounts/bulk_create

Request body

append_label_namesstring[]

Array of label names to add to ALL accounts in this request

run_dedupeboolean

Enable aggressive deduplication by domain, organization_id, and name. When false (default), only matches by CRM IDs. When true, also matches by domain, organization_id, and name. Existing accounts are returned without modification in both modes

Example request

{
  "accounts": [
    {
      "name": "Acme Corporation",
      "domain": "acme.com",
      "owner_id": "507f1f77bcf86cd799439013",
      "phone": "+1-555-0135",
      "raw_address": "123 Main St, San Francisco, CA 94105",
      "linkedin_url": "https://linkedin.com/company/acme",
      "facebook_url": "https://facebook.com/acme",
      "twitter_url": "https://twitter.com/acme",
      "salesforce_id": "001pJNj9pix2idKsfj",
      "hubspot_id": "12345678",
      "organization_id": "507f1f77bcf86cd799439012",
      "parent_account_id": "507f1f77bcf86cd799439016",
      "account_stage_id": "507f1f77bcf86cd799439014",
      "typed_custom_fields": {
        "507f1f77bcf86cd799439020": "High Value",
        "507f1f77bcf86cd799439021": "Q4 2025"
      }
    }
  ],
  "append_label_names": [
    "Enterprise",
    "High Priority"
  ],
  "run_dedupe": true
}

Response

200 - Successful bulk create operation

Example response

{
  "created_accounts": [
    {
      "id": "507f1f77bcf86cd799439011",
      "name": "Acme Corporation",
      "domain": "acme.com",
      "team_id": "507f1f77bcf86cd799439012",
      "owner_id": "507f1f77bcf86cd799439013",
      "account_stage_id": "507f1f77bcf86cd799439014",
      "phone": "+1-555-0135",
      "created_at": "2025-10-16T18:30:00Z",
      "updated_at": "2025-10-16T18:30:00Z"
    }
  ],
  "existing_accounts": [
    {
      "id": "507f1f77bcf86cd799439015",
      "name": "Original Company Name",
      "domain": "existing.com",
      "team_id": "507f1f77bcf86cd799439012",
      "owner_id": "507f1f77bcf86cd799439013",
      "created_at": "2025-09-01T10:00:00Z",
      "updated_at": "2025-09-15T14:30:00Z"
    }
  ]
}