# apollo.people.contacts.create

Save a person as a contact in the account, returning its ID

> Use the create a contact endpoint to add a new contact to your team's Apollo account.

Page: https://telipot.com/catalog/tasks/apollo.people.contacts.create · Markdown: https://telipot.com/catalog/tasks/apollo.people.contacts.create/md · JSON: https://telipot.com/catalog/tasks/apollo.people.contacts.create/json

| Field | Value |
| --- | --- |
| provider | [Apollo](https://telipot.com/catalog/providers/apollo) `apollo` |
| capability | [`people.contacts.create`](https://telipot.com/catalog/capabilities/people.contacts.create) |
| kind | action |
| tier | core |
| price | Free (Free from the tool) |
| identity | Your plan |
| auth | `api_key · in header as x-api-key` |
| scope | own_account |
| principal | organization |
| required_scopes | none |
| retention | standard |
| route | `POST https://api.apollo.io/api/v1/contacts` |
| verification | Not verified yet. Not checked yet. We test with a real request before we mark it. |
| status | live |
| docs | https://docs.apollo.io/reference/create-a-contact |

## Inspect first

No complete example input is recorded. Read the schema and field notes before building the call.

```bash
telipot inspect apollo.people.contacts.create
```

```bash
curl https://api.telipot.com/v1/tasks/apollo.people.contacts.create \
  -H "Authorization: Bearer $TELIPOT_TOKEN"
```

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `first_name` | body | string | no |  | First name of the contact. |
| `last_name` | body | string | no |  | Last name of the contact. |
| `organization_name` | body | string | no |  | Name of the contact's employer. |
| `title` | body | string | no |  | Current job title. |
| `account_id` | body | string | no |  | Apollo ID of the account the contact belongs to. |
| `email` | body | string | no |  | Email address of the contact. |
| `website_url` | body | string | no |  | Corporate website URL. |
| `label_names` | body | array | no |  | Names of the lists the contact belongs to. |
| `contact_stage_id` | body | string | no |  | Apollo ID of the contact stage. |
| `present_raw_address` | body | string | no |  | Personal location of the contact. |
| `direct_phone` | body | string | no |  | Primary phone number. |
| `corporate_phone` | body | string | no |  | Work or office phone number. |
| `mobile_phone` | body | string | no |  | Mobile phone number. |
| `home_phone` | body | string | no |  | Home phone number. |
| `other_phone` | body | string | no |  | Alternative phone number. |
| `typed_custom_fields` | body | object | no |  | Values for the account's custom fields, keyed by the custom field's ID; custom fields are unique to each account. |
| `run_dedupe` | body | boolean | no | default false | Set true to match an existing contact and overwrite it with the values sent instead of always creating a new one; the returned id then belongs to the existing contact. |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "first_name": {
      "type": "string",
      "description": "First name of the contact."
    },
    "last_name": {
      "type": "string",
      "description": "Last name of the contact."
    },
    "organization_name": {
      "type": "string",
      "description": "Name of the contact's employer."
    },
    "title": {
      "type": "string",
      "description": "Current job title."
    },
    "account_id": {
      "type": "string",
      "description": "Apollo ID of the account the contact belongs to."
    },
    "email": {
      "type": "string",
      "description": "Email address of the contact."
    },
    "website_url": {
      "type": "string",
      "description": "Corporate website URL."
    },
    "label_names": {
      "type": "array",
      "description": "Names of the lists the contact belongs to."
    },
    "contact_stage_id": {
      "type": "string",
      "description": "Apollo ID of the contact stage."
    },
    "present_raw_address": {
      "type": "string",
      "description": "Personal location of the contact.",
      "examples": [
        "Atlanta, United States"
      ]
    },
    "direct_phone": {
      "type": "string",
      "description": "Primary phone number."
    },
    "corporate_phone": {
      "type": "string",
      "description": "Work or office phone number."
    },
    "mobile_phone": {
      "type": "string",
      "description": "Mobile phone number."
    },
    "home_phone": {
      "type": "string",
      "description": "Home phone number."
    },
    "other_phone": {
      "type": "string",
      "description": "Alternative phone number."
    },
    "typed_custom_fields": {
      "type": "object",
      "description": "Values for the account's custom fields, keyed by the custom field's ID; custom fields are unique to each account."
    },
    "run_dedupe": {
      "type": "boolean",
      "description": "Set true to match an existing contact and overwrite it with the values sent instead of always creating a new one; the returned id then belongs to the existing contact.",
      "default": false
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "properties": {
    "contact": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "first_name": {
          "type": "string"
        },
        "last_name": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "email": {
          "type": "string"
        },
        "email_status": {
          "type": "string"
        },
        "linkedin_url": {
          "type": [
            "string",
            "null"
          ]
        },
        "organization_name": {
          "type": "string"
        },
        "organization_id": {
          "type": "string"
        },
        "account_id": {
          "type": "string"
        },
        "contact_stage_id": {
          "type": "string"
        },
        "owner_id": {
          "type": "string"
        },
        "created_at": {
          "type": "string"
        },
        "updated_at": {
          "type": "string"
        },
        "label_ids": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    }
  }
}
```