{
  "url": "https://telipot.com/catalog/tasks/apollo.people.contacts.create",
  "id": "apollo.people.contacts.create",
  "name": "Save a person as a contact in the account, returning its ID",
  "provider": {
    "slug": "apollo",
    "name": "Apollo"
  },
  "capability": "people.contacts.create",
  "platform": "people",
  "kind": "action",
  "tier": "core",
  "identity": "key",
  "identityLabel": "Your plan",
  "price": {
    "amount": "Free",
    "state": "free",
    "label": "Free",
    "detail": "Free from the tool",
    "type": "free"
  },
  "providers": 1,
  "retention": "standard",
  "runsOn": "free",
  "live": true,
  "summary": "Use the create a contact endpoint to add a new contact to your team's Apollo account.",
  "method": "POST",
  "path": "/contacts",
  "host": "https://api.apollo.io/api/v1",
  "docsUrl": "https://docs.apollo.io/reference/create-a-contact",
  "auth": {
    "scheme": "api_key",
    "label": "api_key · in header as x-api-key",
    "short": "api_key · x-api-key"
  },
  "scope": "own_account",
  "principal": "organization",
  "requiredScopes": [],
  "verification": {
    "state": "none",
    "label": "Not verified yet",
    "detail": "Not checked yet. We test with a real request before we mark it."
  },
  "input": [
    {
      "name": "first_name",
      "location": "body",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "First name of the contact."
    },
    {
      "name": "last_name",
      "location": "body",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Last name of the contact."
    },
    {
      "name": "organization_name",
      "location": "body",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Name of the contact's employer."
    },
    {
      "name": "title",
      "location": "body",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Current job title."
    },
    {
      "name": "account_id",
      "location": "body",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Apollo ID of the account the contact belongs to."
    },
    {
      "name": "email",
      "location": "body",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Email address of the contact."
    },
    {
      "name": "website_url",
      "location": "body",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Corporate website URL."
    },
    {
      "name": "label_names",
      "location": "body",
      "type": "array",
      "required": false,
      "constraints": [],
      "note": "Names of the lists the contact belongs to."
    },
    {
      "name": "contact_stage_id",
      "location": "body",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Apollo ID of the contact stage."
    },
    {
      "name": "present_raw_address",
      "location": "body",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Personal location of the contact."
    },
    {
      "name": "direct_phone",
      "location": "body",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Primary phone number."
    },
    {
      "name": "corporate_phone",
      "location": "body",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Work or office phone number."
    },
    {
      "name": "mobile_phone",
      "location": "body",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Mobile phone number."
    },
    {
      "name": "home_phone",
      "location": "body",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Home phone number."
    },
    {
      "name": "other_phone",
      "location": "body",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Alternative phone number."
    },
    {
      "name": "typed_custom_fields",
      "location": "body",
      "type": "object",
      "required": false,
      "constraints": [],
      "note": "Values for the account's custom fields, keyed by the custom field's ID; custom fields are unique to each account."
    },
    {
      "name": "run_dedupe",
      "location": "body",
      "type": "boolean",
      "required": false,
      "constraints": [
        "default false"
      ],
      "note": "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."
    }
  ],
  "sampleInput": {},
  "inputSchema": {
    "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": [
    {
      "name": "contact",
      "type": "object"
    }
  ],
  "outputSchema": {
    "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"
            }
          }
        }
      }
    }
  },
  "commands": {
    "mode": "inspect",
    "cli": "telipot inspect apollo.people.contacts.create",
    "http": "curl https://api.telipot.com/v1/tasks/apollo.people.contacts.create \\\n  -H \"Authorization: Bearer $TELIPOT_TOKEN\""
  },
  "siblings": []
}