{
  "url": "https://telipot.com/catalog/capabilities/people.contacts.create",
  "id": "people.contacts.create",
  "description": "Save a person as a contact in the credential's own account",
  "platform": "people",
  "providers": [
    {
      "slug": "apollo",
      "name": "Apollo"
    }
  ],
  "tasks": 1,
  "taskPages": [
    {
      "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": []
    }
  ]
}