# apollo.people.enrich

Person's title, work email from email, LinkedIn URL or name

> Use the people enrichment endpoint to enrich data for one person.

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

| Field | Value |
| --- | --- |
| provider | [Apollo](https://telipot.com/catalog/providers/apollo) `apollo` |
| capability | [`people.enrich`](https://telipot.com/catalog/capabilities/people.enrich) |
| kind | data |
| tier | core |
| price | $0.0196 / call (1 credit · docs) |
| price note | 1 credit when credit-consuming data (demographics or email) is found, 0 when none is. The docs give 1-9 credits per person: +8 when a mobile phone is returned, and waterfall enrichment costs more. This task sends no phone, personal-email or waterfall option, so it is priced at the 1-credit base. |
| identity | Your plan |
| auth | `api_key · in header as x-api-key` |
| scope | any_account |
| principal | organization |
| required_scopes | none |
| retention | standard |
| route | `POST https://api.apollo.io/api/v1/people/match` |
| verification | Untestable. Needs a specific person and answers with that person's profile and work email; a contact lookup, so it has no test request. |
| status | live |
| docs | https://docs.apollo.io/reference/people-enrichment |

## Inspect first

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

```bash
telipot inspect apollo.people.enrich
```

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

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `first_name` | queryParams | string | no |  | First name; use with last_name. |
| `last_name` | queryParams | string | no |  | Last name; use with first_name. |
| `name` | queryParams | string | no |  | Full name; replaces first_name and last_name. Identify the person with an email, a LinkedIn URL, an Apollo ID, or a name plus employer domain; a name alone may return a 200 with no match (check match_confidence). |
| `email` | queryParams | string | no |  | Email address of the person. |
| `hashed_email` | queryParams | string | no |  | MD5 or SHA-256 hash of the person's email. |
| `organization_name` | queryParams | string | no |  | Name of the person's employer, current or previous. |
| `domain` | queryParams | string | no |  | Domain of the person's employer, current or previous, without www. or @. |
| `id` | queryParams | string | no |  | Apollo ID of the person, as people search returns it. |
| `linkedin_url` | queryParams | string | no |  | URL of the person's LinkedIn profile. |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "first_name": {
      "type": "string",
      "description": "First name; use with last_name."
    },
    "last_name": {
      "type": "string",
      "description": "Last name; use with first_name."
    },
    "name": {
      "type": "string",
      "description": "Full name; replaces first_name and last_name. Identify the person with an email, a LinkedIn URL, an Apollo ID, or a name plus employer domain; a name alone may return a 200 with no match (check match_confidence)."
    },
    "email": {
      "type": "string",
      "description": "Email address of the person."
    },
    "hashed_email": {
      "type": "string",
      "description": "MD5 or SHA-256 hash of the person's email."
    },
    "organization_name": {
      "type": "string",
      "description": "Name of the person's employer, current or previous."
    },
    "domain": {
      "type": "string",
      "description": "Domain of the person's employer, current or previous, without www. or @.",
      "examples": [
        "apollo.io"
      ]
    },
    "id": {
      "type": "string",
      "description": "Apollo ID of the person, as people search returns it."
    },
    "linkedin_url": {
      "type": "string",
      "description": "URL of the person's LinkedIn profile."
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "integer",
      "description": "Save to map this request to a webhook result; this task sends no webhook."
    },
    "person": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "first_name": {
          "type": "string"
        },
        "last_name": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "linkedin_url": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "headline": {
          "type": "string"
        },
        "email": {
          "type": "string"
        },
        "email_status": {
          "type": "string"
        },
        "organization_id": {
          "type": "string"
        },
        "match_confidence": {
          "type": "string",
          "enum": [
            "high",
            "medium",
            "low",
            "none"
          ]
        },
        "employment_history": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "organization_id": {
                "type": "string"
              },
              "organization_name": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "start_date": {
                "type": "string"
              },
              "current": {
                "type": "boolean"
              }
            }
          }
        },
        "state": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "country": {
          "type": "string"
        },
        "seniority": {
          "type": "string"
        },
        "departments": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "subdepartments": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "functions": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "organization": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "website_url": {
              "type": "string"
            },
            "primary_domain": {
              "type": "string"
            },
            "industry": {
              "type": "string"
            },
            "estimated_num_employees": {
              "type": "integer"
            }
          }
        }
      }
    }
  }
}
```

## Other tools for this job

- [`hunter.people.enrich`](https://telipot.com/catalog/tasks/hunter.people.enrich) · $0.0049 / email