> ## Documentation Index
> Fetch the complete documentation index at: https://flows-docs.edges.run/llms.txt
> Use this file to discover all available pages before exploring further.

# Fullenrich Enrich People

> Enrich people profiles with verified emails and phone numbers

The Fullenrich Enrich People action finds verified email addresses and phone numbers for people based on their name and company information. This is a standalone action that can be used independently or as part of a flow.

## Input Options

You can provide person information in one of these combinations:

| Option              | Required Fields                           |
| ------------------- | ----------------------------------------- |
| Name + Company      | `first_name`, `last_name`, `company_name` |
| Name + Domain       | `first_name`, `last_name`, `domain`       |
| Full Name + Company | `full_name`, `company_name`               |
| Full Name + Domain  | `full_name`, `domain`                     |

You can also provide a `linkedin_url` for more accurate matching.

## Credit Costs

| Enrich Level        | Credits per Person |
| ------------------- | ------------------ |
| `emails`            | 2 credits          |
| `phones`            | 20 credits         |
| `emails_and_phones` | 22 credits         |

<Warning>
  This action **requires a callback URL**. Results are delivered asynchronously to your webhook endpoint.
</Warning>

<Accordion title="Custom Data">
  Each item in the `inputs` array can include an optional **`custom_data`** object. The only valid key inside `custom_data` is **`meta`**. Use `meta` to attach a free-form object (e.g. your own IDs, tags, or context) that will be passed through and available in the flow output.

  **Example:**

  ```json theme={null}
  "inputs": [
    {
      ...
      "custom_data": {
        "meta": {
          "foo": "bar",
          "crm_id": 1234
        }
      }
    }
  ]
  ```

  <Info>
    We currently require **`meta`** as a workaround to ship this capability; a more solid implementation will follow soon without breaking changes.
  </Info>
</Accordion>

**Examples**:

<AccordionGroup>
  <Accordion title="Enrich with emails only">
    ```bash theme={null}
    curl --request POST \
      --url https://api.edges.run/v1/actions/fullenrich-enrich-people/run/async \
      --header 'Content-Type: application/json' \
      --header 'X-API-Key: <your-api-key>' \
      --data '{
      "parameters": {
        "enrich_level": "emails"
      },
      "inputs": [
        {
          "first_name": "John",
          "last_name": "Doe",
          "company_name": "Acme Inc"
        },
        {
          "full_name": "Jane Smith",
          "domain": "example.com"
        }
      ],
      "callback": {
        "url": "https://your-app.com/webhook/enrichment",
        "headers": {
          "Authorization": "Bearer your-webhook-token"
        }
      }
    }'
    ```
  </Accordion>

  <Accordion title="Enrich with emails and phones">
    ```bash theme={null}
    curl --request POST \
      --url https://api.edges.run/v1/actions/fullenrich-enrich-people/run/async \
      --header 'Content-Type: application/json' \
      --header 'X-API-Key: <your-api-key>' \
      --data '{
      "parameters": {
        "enrich_level": "emails_and_phones"
      },
      "inputs": [
        {
          "first_name": "John",
          "last_name": "Doe",
          "company_name": "Acme Inc",
          "linkedin_url": "https://linkedin.com/in/johndoe"
        }
      ],
      "callback": {
        "url": "https://your-app.com/webhook/enrichment"
      }
    }'
    ```
  </Accordion>

  <Accordion title="Bulk enrichment with custom data">
    ```bash theme={null}
    curl --request POST \
      --url https://api.edges.run/v1/actions/fullenrich-enrich-people/run/async \
      --header 'Content-Type: application/json' \
      --header 'X-API-Key: <your-api-key>' \
      --data '{
      "parameters": {
        "enrich_level": "emails"
      },
      "inputs": [
        {
          "first_name": "John",
          "last_name": "Doe",
          "domain": "acme.com",
          "custom_data": {
            "lead_id": "12345",
            "source": "linkedin_campaign"
          }
        }
      ],
      "callback": {
        "url": "https://your-app.com/webhook/enrichment"
      }
    }'
    ```
  </Accordion>
</AccordionGroup>

<Info>
  Results are delivered to your callback URL. Learn more about [webhook payloads and handling](/api/callbacks).
</Info>