Bulk Create Contacts

post

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

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 does NOT update existing ones (except for placeholder contacts from email imports). Existing contacts that match the criteria will be 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

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 without modifying them (except email_import placeholders which are still merged). Matches by email, CRM IDs, or name + organization

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/plain

200200 - Successful bulk create operation

401401 - Unauthorized

422422 - Unprocessable Entity

429429 - Too Many Requests

500500 - Internal Server Error