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

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 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

Loading…

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