v1

latestOpenAPI 3.1.02026-07-247601.0 MB

Contacts

Create a Contact

This endpoint doesn't consume Apollo credits. Learn more about API pricing and credits.

<a href="https://knowledge.apollo.io/hc/en-us/articles/5995459280525-View-and-Edit-Contacts" target="_blank">Contacts</a> are people saved in Apollo. Use the Create a Contact endpoint to add a new contact to your team's Apollo account. By default, Apollo doesn't apply deduplication processes when you create a new contact via API. If your entry has the same name, email address, or other details as an existing contact, Apollo creates a new contact instead of updating the existing contact. To enable deduplication and prevent duplicate contacts, set the <code>run_dedupe</code> parameter to <code>true</code>. To update an existing contact, use the <a href="https://docs.apollo.io/reference/update-a-contact">Update a Contact endpoint</a> instead.

post/contacts

Request body

first_namestring

The first name of the contact you want to create. Example: Tim

last_namestring

The last name of the contact you want to create. Example: Zheng

organization_namestring

The name of the contact's employer (company). Example: apollo

titlestring

The current job title that the contact holds. Example: senior research analyst

account_idstring

The Apollo ID for the account. Example: 63f53afe4ceeca00016bdd2f

emailstring

The email address of the contact. Example: example@email.com

website_urlstring

The corporate website URL. Example: https://www.apollo.io/

label_namesstring[]

Lists to which the contact belongs.

contact_stage_idstring

The Apollo ID for the contact stage. Example: 6095a710bd01d100a506d4ae

present_raw_addressstring

The personal location for the contact. Example: Atlanta, United States

direct_phonestring

The primary phone number. Example: 555-555-0133

corporate_phonestring

The work/office phone number. Example: +44 7700 900852

mobile_phonestring

The mobile phone number. Example: 555-555-0133

home_phonestring

The home phone number. Example: 555-555-0133

other_phonestring

Alternative phone number. Example: 555-555-0133

typed_custom_fieldsobject

Add information to <a href="https://knowledge.apollo.io/hc/en-us/articles/4412498825869-Create-Custom-Contact-Fields" target="_blank">custom fields</a> in Apollo. Your custom fields are unique to your team's Apollo account. This means that the examples in this documentation may not work for your testing purposes. To utilize this parameter successfully, call the <a href="https://docs.apollo.io/reference/get-a-list-of-all-custom-fields">Get a List of All Custom Fields</a> endpoint and identify the id value for the custom field, as well as the appropriate data type. For example, if a custom field accepts picklist entries, you need to pass the accompanying id value for the picklist entry that you want to use as the input value. Example: When the <a href="https://docs.apollo.io/reference/get-a-list-of-all-custom-fields">Get a List of All Custom Fields</a> endpoint returns an id of field:

"60c39ed82bd02f01154c470a" (datetime)

then the value passed should be:

{"60c39ed82bd02f01154c470a": "2025-08-07"}

run_dedupeboolean

Set to true to enable deduplication logic that prevents creating duplicate contacts. When enabled, Apollo will check for existing contacts with matching email addresses, names, or other identifying information and return the existing contact instead of creating a duplicate. The default value is false. When deduplication is enabled, performance may be slightly impacted due to the additional validation checks, but this ensures data integrity and prevents duplicate entries in your database.

Example request

{
  "typed_custom_fields": {
    "60c39ed82bd02f01154c470a": "2025-08-07"
  }
}

Response

200

Example response

{
  "contact": {
    "id": "66e34b81740c50074e3d1bd4",
    "first_name": "Fyodor",
    "last_name": "Dostoevsky",
    "name": "Fyodor Dostoevsky",
    "title": "Chief Fiction Writer",
    "contact_stage_id": "6095a710bd01d100a506d4ae",
    "owner_id": "60affe7d6e270a00f5db6fe4",
    "creator_id": "60affe7d6e270a00f5db6fe4",
    "organization_name": "Apollo.io",
    "source": "api",
    "original_source": "api",
    "organization_id": "5e66b6381e05b4008c8331b8",
    "present_raw_address": "St. Petersburg, Russia",
    "created_at": "2024-09-12T20:13:53.207Z",
    "email_status": "verified",
    "account_id": "63f53afe4ceeca00016bdd2f",
    "sanitized_phone": "+15555550149",
    "updated_at": "2024-09-12T20:13:53.331Z",
    "queued_for_crm_push": true,
    "label_ids": [
      "66e34b81740c50074e3d1bd0"
    ],
    "existence_level": "full",
    "email": "fyodo@apollo.io",
    "email_from_customer": true,
    "email_true_status": "User Managed",
    "updated_email_true_status": true,
    "source_display_name": "Created from API",
    "contact_campaign_statuses": [
      {
        "id": "68782af181c7f0002159df25",
        "emailer_campaign_id": "66e9e215ece19801b219997f",
        "send_email_from_user_id": "66302798d03b9601c7934ebf",
        "inactive_reason": "Sequence inactive",
        "status": "paused",
        "added_at": "2025-07-16T22:42:57.372+00:00",
        "added_by_user_id": "60affe7d6e270a00f5db6fe4",
        "send_email_from_email_address": "test.marcus.hale@apollomail.io",
        "send_email_from_email_account_id": "6633baaece5fbd01c791d7ca"
      }
    ],
    "time_zone": "Asia/Krasnoyarsk",
    "city": "Saint Petersburg",
    "state": "Saint Petersburg",
    "country": "Russia",
    "phone_numbers": [
      {
        "raw_number": "555-555-0149",
        "sanitized_number": "+15555550149",
        "type": "work_direct",
        "status": "no_status"
      }
    ]
  },
  "labels": [
    {
      "id": "66e34b81740c50074e3d1bd2",
      "modality": "contacts",
      "name": "typewriter",
      "created_at": "2024-09-12T20:13:53.119Z",
      "updated_at": "2024-09-12T20:13:53.279Z",
      "user_id": "60affe7d6e270a00f5db6fe4"
    }
  ]
}