Bulk Create Contacts

post

https://api.apollo.io/api/v1/contacts/bulk_create

Endpoint essentials
API key access	`api/v1/contacts/bulk_create` or `Master API key`
OAuth scopes	`contacts_bulk_create`
Credit usage	`0 credits` Learn more about API pricing and credits.

Contacts are people saved in Apollo.

Use the Bulk Create Contacts endpoint to create up to 100 contacts in a single API request. This endpoint supports intelligent deduplication and returns separated arrays for newly created and existing contacts.

Important: This endpoint creates new contacts but doesn't update existing ones (except for placeholder contacts from email imports). Existing contacts that match the criteria are returned in the existing_contacts array without modification.

To update existing contacts, use the Bulk Update Contacts endpoint.

Body Params

contacts

array of objects

required

length ≤ 100

Array of contact objects to create (maximum 100 contacts per request)

contacts*

append_label_names

array of strings

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

append_label_names

owner_id

string

Owner user ID applied to all contacts in this batch. Defaults to current user if omitted. Returns 422 if the ID does not belong to the current team.

run_dedupe

boolean

Defaults to false

Enable full deduplication across all sources. When false (default), creates duplicates for non-email_import sources and merges with email_import placeholders only. When true, returns existing contacts in existing_contacts without modifying them (except email_import placeholders, which are still merged).

Matching is checked in order: id, CRM identifiers, person_id, email (against the contact's primary and additional emails), then name plus company (matched on email domain, organization_id, or organization_name).

Unlike Create a Contact, this endpoint never overwrites a matched contact's fields.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Bulk Create Contacts

What’s Next

What’s Next

200200 - Successful bulk create operation

401401 - Unauthorized

422422 - Unprocessable Entity

429429 - Too Many Requests

500500 - Internal Server Error

What’s Next

What’s Next