Create a Contact

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

Use the Create a Contact endpoint to add a new contact to your team's Apollo account.

In Apollo terminology, a contact is a person that your team has explicitly added to your database. A contact will have their data enriched in some way, such as accessing an email address or a phone number.

Apollo does not apply deduplication processes when you create a new contact via the API. If your entry has the same name, email address, or other details as an existing contact, Apollo will create a new contact instead of updating the existing contact.

To update an existing contact, use the Update a Contact endpoint instead.

Query Params

first_name

string

The first name of the contact you want to create. This should be a human-readable name.

Example: Tim

last_name

string

The last name of the contact you want to create. This should be a human-readable name.

Example: Zheng

organization_name

string

The name of the contact's employer (company). This should be the current employer.

To ensure a contact is assigned to the right company in the Apollo contact base, check the exact company name using the Organization Search endpoint.

Example: apollo

title

string

The current job title that the contact holds.

Example: senior research analyst

account_id

string

The Apollo ID for the account to which you want to assign the contact. Each company with enriched data is assigned a unique account ID.

To find account IDs, call the Organization Search endpoint and identify the value for id within the accounts[] array for each company. If a company is not already part of an account within your Apollo instance, you instead need to call either the Organization Enrichment endpoint or the Bulk Organization Enrichment endpoint to enrich the organization's data, then identify the value for account_id for the company.

Be sure you understand the difference between organization IDs and account IDs. Every company in the Apollo database is assigned an organization ID, but only companies with enriched data are assigned an account ID. If you use an organization ID with this endpoint, you might still receive a 200 response, but the contact will be created without being assigned to the desired account.

Example: 63f53afe4ceeca00016bdd2f

string

The email address of the contact.

Example: example@email.com

website_url

string

The corporate website URL for the contact's current employer (company).

This should be the full URL, including https://www., .com, and similar. Do not add URL slugs or sub-directories.

Do not use social media URLs, such as LinkedIn profile links. This will lead to inaccurate data enrichment for the contact.

Examples: https://www.apollo.io/; https://www.microsoft.com/

label_names[]

array of strings

Add the contact to lists within your team's Apollo account. If your entry does not match the name of a list within your account, Apollo automatically creates a new list.

Lists enable your team to consolidate related contacts and accounts so you can more easily prospect and engage them. When in the Apollo product (not API), users can use lists as a search filter, add lists to a sequence to automate outreach, and add lists to workflows for task scheduling and sequence maintenance.

Examples: 2024 big marketing conference attendees; inbound contact; smb clients

label_names[]

contact_stage_id

string

The Apollo ID for the contact stage to which you want to assign the contact. Call the List Contact Stages endpoint to retrieve a list of all the contact stage IDs available in your Apollo account.

If you do not specify the contact stage, Apollo automatically assigns the contact to a stage as determined by your team's Apollo account. To change the order of contact stages, launch the Apollo product and go to Settings > Objects > Contacts. Then, access the Triggers tab and change default stage for when a prospect is created.

Example: 6095a710bd01d100a506d4ae

present_raw_address

string

The personal location for the contact. This can include a city, US state, and country.

Apollo matches the location you provide to the most applicable pre-defined location.

Examples: Atlanta, United States; Tokyo, Japan; Saint Petersburg, Russia

direct_phone

string

The primary phone number for the contact.

Apollo sanitizes phone numbers, so you can enter them in any format. The sanitized number can be viewed in the endpoint response.

Examples: 555-303-1234; +44 7911 123456

corporate_phone

string

The work/office phone number for the contact.

This is a direct line to the contact at their employer, not the corporate headquarters phone number.

Apollo sanitizes phone numbers, so you can enter them in any format. The sanitized number can be viewed in the endpoint response.

Examples: 555-303-1234; +44 7911 123456

mobile_phone

string

The mobile phone number for the contact.

Apollo sanitizes phone numbers, so you can enter them in any format. The sanitized number can be viewed in the endpoint response.

Examples: 555-303-1234; +44 7911 123456

home_phone

string

The home phone number for the contact.

Apollo sanitizes phone numbers, so you can enter them in any format. The sanitized number can be viewed in the endpoint response.

Examples: 555-303-1234; +44 7911 123456

other_phone

string

An unknown type of phone number or an alternative phone number for the contact.

Apollo sanitizes phone numbers, so you can enter them in any format. The sanitized number can be viewed in the endpoint response.

Examples: 555-303-1234; +44 7911 123456

Responses

Response body

object

contact

object

contact_roles

array

contact_roles

string

first_name

string

last_name

string

name

string

linkedin_url

string

title

string

contact_stage_id

string

owner_id

string

creator_id

string

person_id

string

email_needs_tickling

string

organization_name

string

source

string

original_source

string

organization_id

string

headline

string

photo_url

string

present_raw_address

string

linkedin_uid

string

extrapolated_email_confidence

string

salesforce_id

string

salesforce_lead_id

string

salesforce_contact_id

string

salesforce_account_id

string

crm_owner_id

string

created_at

string

emailer_campaign_ids

array

emailer_campaign_ids

direct_dial_status

string

direct_dial_enrichment_failed_at

string

email_status

string

email_source

string

account_id

string

last_activity_date

string

hubspot_vid

string

hubspot_company_id

string

crm_id

string

sanitized_phone

string

merged_crm_ids

string

updated_at

string

queued_for_crm_push

boolean

Defaults to true

suggested_from_rule_engine_config_id

string

email_unsubscribed

string

label_ids

array of strings

label_ids

has_pending_email_arcgate_request

boolean

Defaults to true

has_email_arcgate_request

boolean

Defaults to true

existence_level

string

email_from_customer

boolean

Defaults to true

typed_custom_fields

object

custom_field_errors

object

crm_record_url

string

email_status_unavailable_reason

string

email_true_status

string

updated_email_true_status

boolean

Defaults to true

contact_rule_config_statuses

array

contact_rule_config_statuses

source_display_name

string

twitter_url

string

contact_campaign_statuses

array

contact_campaign_statuses

contact_emails

array

contact_emails

next_contact_id

string

time_zone

string

city

string

state

string

country

string

intent_strength

string

show_intent

boolean

Defaults to true

phone_numbers

array of objects

phone_numbers

object

raw_number

string

sanitized_number

string

type

string

position

integer

Defaults to 0

status

string

dnc_status

string

dnc_other_info

string

dialer_flags

string

account_phone_note

string

free_domain

boolean

Defaults to true

is_likely_to_engage

boolean

Defaults to true

email_domain_catchall

boolean

Defaults to true

labels

array of objects

labels

object

string

modality

string

cached_count

integer

Defaults to 0

name

string

created_at

string

updated_at

string

user_id

string

200200

401401

422422

429429