{
  "id": "apollo.people.match",
  "object": "tool",
  "name": "Apollo People Enrichment",
  "summary": "Enrich one person — verified email, title, employer, history — from an email, name, LinkedIn URL, or Apollo id.",
  "description": "Resolve a known person into a complete profile: verified work email, job title, seniority, department, employment history, location, and current employer details. Accepts any identifier — email, name plus company, LinkedIn URL, or Apollo person id — and more identifiers improve the match; match_confidence in the response says how sure Apollo is (none = no record enriched). The step that reveals the contact data People Search withholds; best for lead enrichment, contact appending, and CRM hygiene. Phone numbers are not available through this endpoint.\n\nRaw apollo#people/match endpoint: input is { body, queryParams, pathParams } as the provider documents them (https://docs.apollo.io/reference/people-enrichment).",
  "category": "lookup",
  "hosted_by": "Apollo",
  "runtime": "partner",
  "side_effects": false,
  "status": "live",
  "credits": 0,
  "price": null,
  "providers": [
    {
      "id": "apollo",
      "name": "Apollo",
      "price": null,
      "own_key_only": true
    }
  ],
  "mcp_name": "apollo_people_match",
  "input_schema": {
    "type": "object",
    "properties": {
      "queryParams": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "first_name": {
                "type": "string",
                "minLength": 1,
                "description": "First name; typically used with last_name."
              },
              "last_name": {
                "type": "string",
                "minLength": 1,
                "description": "Last name; typically used with first_name."
              },
              "name": {
                "type": "string",
                "minLength": 1,
                "description": "Full name (first and last separated by a space); replaces first_name + last_name."
              },
              "email": {
                "type": "string",
                "minLength": 1,
                "description": "Email address."
              },
              "hashed_email": {
                "type": "string",
                "pattern": "^([A-Fa-f0-9]{32}|[A-Fa-f0-9]{64})$",
                "description": "MD5 or SHA-256 hash of the email address."
              },
              "organization_name": {
                "type": "string",
                "minLength": 1,
                "description": "Employer name, current or previous."
              },
              "domain": {
                "type": "string",
                "minLength": 1,
                "description": "Employer domain, current or previous (no www. or @), e.g. 'apollo.io'."
              },
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Apollo person id (from People Search)."
              },
              "linkedin_url": {
                "type": "string",
                "pattern": "^https?:\\/\\/\\S+$",
                "description": "LinkedIn profile URL."
              },
              "reveal_personal_emails": {
                "type": "boolean",
                "description": "Also return personal emails (not revealed for people in GDPR-compliant regions). Default false."
              }
            },
            "required": [
              "first_name"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "first_name": {
                "type": "string",
                "minLength": 1,
                "description": "First name; typically used with last_name."
              },
              "last_name": {
                "type": "string",
                "minLength": 1,
                "description": "Last name; typically used with first_name."
              },
              "name": {
                "type": "string",
                "minLength": 1,
                "description": "Full name (first and last separated by a space); replaces first_name + last_name."
              },
              "email": {
                "type": "string",
                "minLength": 1,
                "description": "Email address."
              },
              "hashed_email": {
                "type": "string",
                "pattern": "^([A-Fa-f0-9]{32}|[A-Fa-f0-9]{64})$",
                "description": "MD5 or SHA-256 hash of the email address."
              },
              "organization_name": {
                "type": "string",
                "minLength": 1,
                "description": "Employer name, current or previous."
              },
              "domain": {
                "type": "string",
                "minLength": 1,
                "description": "Employer domain, current or previous (no www. or @), e.g. 'apollo.io'."
              },
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Apollo person id (from People Search)."
              },
              "linkedin_url": {
                "type": "string",
                "pattern": "^https?:\\/\\/\\S+$",
                "description": "LinkedIn profile URL."
              },
              "reveal_personal_emails": {
                "type": "boolean",
                "description": "Also return personal emails (not revealed for people in GDPR-compliant regions). Default false."
              }
            },
            "required": [
              "last_name"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "first_name": {
                "type": "string",
                "minLength": 1,
                "description": "First name; typically used with last_name."
              },
              "last_name": {
                "type": "string",
                "minLength": 1,
                "description": "Last name; typically used with first_name."
              },
              "name": {
                "type": "string",
                "minLength": 1,
                "description": "Full name (first and last separated by a space); replaces first_name + last_name."
              },
              "email": {
                "type": "string",
                "minLength": 1,
                "description": "Email address."
              },
              "hashed_email": {
                "type": "string",
                "pattern": "^([A-Fa-f0-9]{32}|[A-Fa-f0-9]{64})$",
                "description": "MD5 or SHA-256 hash of the email address."
              },
              "organization_name": {
                "type": "string",
                "minLength": 1,
                "description": "Employer name, current or previous."
              },
              "domain": {
                "type": "string",
                "minLength": 1,
                "description": "Employer domain, current or previous (no www. or @), e.g. 'apollo.io'."
              },
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Apollo person id (from People Search)."
              },
              "linkedin_url": {
                "type": "string",
                "pattern": "^https?:\\/\\/\\S+$",
                "description": "LinkedIn profile URL."
              },
              "reveal_personal_emails": {
                "type": "boolean",
                "description": "Also return personal emails (not revealed for people in GDPR-compliant regions). Default false."
              }
            },
            "required": [
              "name"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "first_name": {
                "type": "string",
                "minLength": 1,
                "description": "First name; typically used with last_name."
              },
              "last_name": {
                "type": "string",
                "minLength": 1,
                "description": "Last name; typically used with first_name."
              },
              "name": {
                "type": "string",
                "minLength": 1,
                "description": "Full name (first and last separated by a space); replaces first_name + last_name."
              },
              "email": {
                "type": "string",
                "minLength": 1,
                "description": "Email address."
              },
              "hashed_email": {
                "type": "string",
                "pattern": "^([A-Fa-f0-9]{32}|[A-Fa-f0-9]{64})$",
                "description": "MD5 or SHA-256 hash of the email address."
              },
              "organization_name": {
                "type": "string",
                "minLength": 1,
                "description": "Employer name, current or previous."
              },
              "domain": {
                "type": "string",
                "minLength": 1,
                "description": "Employer domain, current or previous (no www. or @), e.g. 'apollo.io'."
              },
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Apollo person id (from People Search)."
              },
              "linkedin_url": {
                "type": "string",
                "pattern": "^https?:\\/\\/\\S+$",
                "description": "LinkedIn profile URL."
              },
              "reveal_personal_emails": {
                "type": "boolean",
                "description": "Also return personal emails (not revealed for people in GDPR-compliant regions). Default false."
              }
            },
            "required": [
              "email"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "first_name": {
                "type": "string",
                "minLength": 1,
                "description": "First name; typically used with last_name."
              },
              "last_name": {
                "type": "string",
                "minLength": 1,
                "description": "Last name; typically used with first_name."
              },
              "name": {
                "type": "string",
                "minLength": 1,
                "description": "Full name (first and last separated by a space); replaces first_name + last_name."
              },
              "email": {
                "type": "string",
                "minLength": 1,
                "description": "Email address."
              },
              "hashed_email": {
                "type": "string",
                "pattern": "^([A-Fa-f0-9]{32}|[A-Fa-f0-9]{64})$",
                "description": "MD5 or SHA-256 hash of the email address."
              },
              "organization_name": {
                "type": "string",
                "minLength": 1,
                "description": "Employer name, current or previous."
              },
              "domain": {
                "type": "string",
                "minLength": 1,
                "description": "Employer domain, current or previous (no www. or @), e.g. 'apollo.io'."
              },
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Apollo person id (from People Search)."
              },
              "linkedin_url": {
                "type": "string",
                "pattern": "^https?:\\/\\/\\S+$",
                "description": "LinkedIn profile URL."
              },
              "reveal_personal_emails": {
                "type": "boolean",
                "description": "Also return personal emails (not revealed for people in GDPR-compliant regions). Default false."
              }
            },
            "required": [
              "hashed_email"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "first_name": {
                "type": "string",
                "minLength": 1,
                "description": "First name; typically used with last_name."
              },
              "last_name": {
                "type": "string",
                "minLength": 1,
                "description": "Last name; typically used with first_name."
              },
              "name": {
                "type": "string",
                "minLength": 1,
                "description": "Full name (first and last separated by a space); replaces first_name + last_name."
              },
              "email": {
                "type": "string",
                "minLength": 1,
                "description": "Email address."
              },
              "hashed_email": {
                "type": "string",
                "pattern": "^([A-Fa-f0-9]{32}|[A-Fa-f0-9]{64})$",
                "description": "MD5 or SHA-256 hash of the email address."
              },
              "organization_name": {
                "type": "string",
                "minLength": 1,
                "description": "Employer name, current or previous."
              },
              "domain": {
                "type": "string",
                "minLength": 1,
                "description": "Employer domain, current or previous (no www. or @), e.g. 'apollo.io'."
              },
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Apollo person id (from People Search)."
              },
              "linkedin_url": {
                "type": "string",
                "pattern": "^https?:\\/\\/\\S+$",
                "description": "LinkedIn profile URL."
              },
              "reveal_personal_emails": {
                "type": "boolean",
                "description": "Also return personal emails (not revealed for people in GDPR-compliant regions). Default false."
              }
            },
            "required": [
              "organization_name"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "first_name": {
                "type": "string",
                "minLength": 1,
                "description": "First name; typically used with last_name."
              },
              "last_name": {
                "type": "string",
                "minLength": 1,
                "description": "Last name; typically used with first_name."
              },
              "name": {
                "type": "string",
                "minLength": 1,
                "description": "Full name (first and last separated by a space); replaces first_name + last_name."
              },
              "email": {
                "type": "string",
                "minLength": 1,
                "description": "Email address."
              },
              "hashed_email": {
                "type": "string",
                "pattern": "^([A-Fa-f0-9]{32}|[A-Fa-f0-9]{64})$",
                "description": "MD5 or SHA-256 hash of the email address."
              },
              "organization_name": {
                "type": "string",
                "minLength": 1,
                "description": "Employer name, current or previous."
              },
              "domain": {
                "type": "string",
                "minLength": 1,
                "description": "Employer domain, current or previous (no www. or @), e.g. 'apollo.io'."
              },
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Apollo person id (from People Search)."
              },
              "linkedin_url": {
                "type": "string",
                "pattern": "^https?:\\/\\/\\S+$",
                "description": "LinkedIn profile URL."
              },
              "reveal_personal_emails": {
                "type": "boolean",
                "description": "Also return personal emails (not revealed for people in GDPR-compliant regions). Default false."
              }
            },
            "required": [
              "domain"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "first_name": {
                "type": "string",
                "minLength": 1,
                "description": "First name; typically used with last_name."
              },
              "last_name": {
                "type": "string",
                "minLength": 1,
                "description": "Last name; typically used with first_name."
              },
              "name": {
                "type": "string",
                "minLength": 1,
                "description": "Full name (first and last separated by a space); replaces first_name + last_name."
              },
              "email": {
                "type": "string",
                "minLength": 1,
                "description": "Email address."
              },
              "hashed_email": {
                "type": "string",
                "pattern": "^([A-Fa-f0-9]{32}|[A-Fa-f0-9]{64})$",
                "description": "MD5 or SHA-256 hash of the email address."
              },
              "organization_name": {
                "type": "string",
                "minLength": 1,
                "description": "Employer name, current or previous."
              },
              "domain": {
                "type": "string",
                "minLength": 1,
                "description": "Employer domain, current or previous (no www. or @), e.g. 'apollo.io'."
              },
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Apollo person id (from People Search)."
              },
              "linkedin_url": {
                "type": "string",
                "pattern": "^https?:\\/\\/\\S+$",
                "description": "LinkedIn profile URL."
              },
              "reveal_personal_emails": {
                "type": "boolean",
                "description": "Also return personal emails (not revealed for people in GDPR-compliant regions). Default false."
              }
            },
            "required": [
              "id"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "first_name": {
                "type": "string",
                "minLength": 1,
                "description": "First name; typically used with last_name."
              },
              "last_name": {
                "type": "string",
                "minLength": 1,
                "description": "Last name; typically used with first_name."
              },
              "name": {
                "type": "string",
                "minLength": 1,
                "description": "Full name (first and last separated by a space); replaces first_name + last_name."
              },
              "email": {
                "type": "string",
                "minLength": 1,
                "description": "Email address."
              },
              "hashed_email": {
                "type": "string",
                "pattern": "^([A-Fa-f0-9]{32}|[A-Fa-f0-9]{64})$",
                "description": "MD5 or SHA-256 hash of the email address."
              },
              "organization_name": {
                "type": "string",
                "minLength": 1,
                "description": "Employer name, current or previous."
              },
              "domain": {
                "type": "string",
                "minLength": 1,
                "description": "Employer domain, current or previous (no www. or @), e.g. 'apollo.io'."
              },
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Apollo person id (from People Search)."
              },
              "linkedin_url": {
                "type": "string",
                "pattern": "^https?:\\/\\/\\S+$",
                "description": "LinkedIn profile URL."
              },
              "reveal_personal_emails": {
                "type": "boolean",
                "description": "Also return personal emails (not revealed for people in GDPR-compliant regions). Default false."
              }
            },
            "required": [
              "linkedin_url"
            ],
            "additionalProperties": false
          }
        ],
        "description": "Provide at least one person identifier: first_name, last_name, name, email, hashed_email, organization_name, domain, id, or linkedin_url. reveal_personal_emails is a modifier, not an identifier."
      }
    },
    "required": [],
    "additionalProperties": false
  },
  "kind": "endpoint"
}