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

# Wiza: Reveal Person

> Find a person's work email and phone number from a LinkedIn or Sales Navigator profile URL, an email, or name plus company domain. waits until the reveal.

Find a person's work email and phone number from a LinkedIn or Sales Navigator profile URL, an email, or name plus company domain. waits until the reveal.

> [!NOTE]
>
> Tool ID: `wiza_reveal_person`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'wiza_reveal_person',
  {
    "individual_reveal": {
      "profile_url": "https://example.com"
    },
    "enrichment_level": "none",
    "email_options": {
      "accept_work": true,
      "accept_personal": true
    }
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute wiza_reveal_person --input '{
  "individual_reveal": {
    "profile_url": "https://example.com"
  },
  "enrichment_level": "none",
  "email_options": {
    "accept_work": true,
    "accept_personal": true
  }
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "id": 123,
    "status": "example",
    "enrichment_level": "example"
  }
}
```

Use `deepline describe wiza_reveal_person --json` for the latest machine-readable contract.

## Input reference

\> Start an individual reveal. An individual reveal is a single contact enrichment. You can provide a name, company, and domain, or an email, or a LinkedIn profile URL. > Either `company` (company name) or `domain` is required when using contact details. Once the reveal is completed, an update will be posted to the webhook URL as configured in your [ account settings ](http://wiza.co/app/settings/api). The payload will be the same as the response of the Get Individual Reveal endpoint. If you wish to do added authentication, the headers in the webhook request will include `x-auth-key` which will be a SHA256 hash of your api key. You can get the status of the individual reveal by calling the `GET /api/individual_reveals/:id` endpoint.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.individual_reveal` | `object` | No | — | — |
| `payload.enrichment_level` | `"none" \| "partial" \| "phone" \| "full"` | No | — | > Enrichment level of the list. \| Enrichment Level \| Description \| \|--------\|--------------------------------------\| \| none \| Will enrich with contact's data when you provide a Linkedin profile url or email. But will not find emails or phone numbers \| \| partial\| Will find email. \| \| phone \| Will find phone numbers. \| \| full \| Will find email and phone numbers. \| Allowed: `none`, `partial`, `phone`, `full`. |
| `payload.email_options` | `object \| string \| array` | No | — | — |
| `payload.callback_url` | `string` | No | — | URL to send the individual reveal update to. If not provided, the default webhook URL configured in your account settings will be used. |
| `payload.reveal_options` | `object` | No | — | Optional advanced reveal options. |
| `payload.linkedin_url` | `string` | No | — | Deprecated compatibility alias for individual\_reveal.profile\_url. |
| `payload.profile_url` | `string` | No | — | Deprecated compatibility alias for individual\_reveal.profile\_url. |
| `payload.email` | `string` | No | — | Deprecated compatibility alias for individual\_reveal.email. |
| `payload.full_name` | `string` | No | — | Deprecated compatibility alias for individual\_reveal.full\_name. |
| `payload.first_name` | `string` | No | — | Deprecated compatibility alias used with last\_name to build individual\_reveal.full\_name. |
| `payload.last_name` | `string` | No | — | Deprecated compatibility alias used with first\_name to build individual\_reveal.full\_name. |
| `payload.company_name` | `string` | No | — | Deprecated compatibility alias for individual\_reveal.company. |
| `payload.company_domain` | `string` | No | — | Deprecated compatibility alias for individual\_reveal.domain. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "> Start an individual reveal. An individual reveal is a single contact enrichment. You can provide a name, company, and domain, or an email, or a LinkedIn profile URL. > Either `company` (company name) or `domain` is required when using contact details. Once the reveal is completed, an update will be posted to the webhook URL as configured in your [ account settings ]( http://wiza.co/app/settings/api ). The payload will be the same as the response of the Get Individual Reveal endpoint. If you wish to do added authentication, the headers in the webhook request will include `x-auth-key` which will be a SHA256 hash of your api key. You can get the status of the individual reveal by calling the `GET /api/individual_reveals/:id` endpoint.",
    "properties": {
      "individual_reveal": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "profile_url": {
                "type": "string",
                "description": "URL of the Linkedin profile. e.g. \"https://www.linkedin.com/in/stephen-hakami-5babb21b0/\"."
              }
            },
            "required": [
              "profile_url"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "full_name": {
                "type": "string",
                "description": "Full name of the contact. e.g. \"Stephen Hakami\"."
              },
              "company": {
                "type": "string",
                "description": "Name of the company. e.g. \"Wiza\". Either company (company name) or domain is required."
              },
              "domain": {
                "type": "string",
                "description": "Domain of the company. e.g. \"wiza.co\". Either company (company name) or domain is required."
              },
              "profile_url": {
                "type": "string",
                "description": "URL of the Linkedin profile. e.g. \"https://www.linkedin.com/in/stephen-hakami-5babb21b0/\"."
              },
              "email": {
                "type": "string",
                "description": "Email address of the contact."
              }
            },
            "required": [
              "full_name"
            ],
            "anyOf": [
              {
                "required": [
                  "company"
                ]
              },
              {
                "required": [
                  "domain"
                ]
              }
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "email": {
                "type": "string",
                "description": "Email address of the contact."
              }
            },
            "required": [
              "email"
            ],
            "additionalProperties": false
          }
        ]
      },
      "enrichment_level": {
        "type": "string",
        "description": "> Enrichment level of the list. | Enrichment Level | Description | |--------|--------------------------------------| | none | Will enrich with contact's data when you provide a Linkedin profile url or email. But will not find emails or phone numbers | | partial| Will find email. | | phone | Will find phone numbers. | | full | Will find email and phone numbers. |",
        "enum": [
          "none",
          "partial",
          "phone",
          "full"
        ]
      },
      "email_options": {
        "anyOf": [
          {
            "type": "object",
            "description": "Types of emails to return. If not provided, all emails will be returned.",
            "properties": {
              "accept_work": {
                "type": "boolean",
                "description": "Professional email address, i.e. tim.cooke@apple.com"
              },
              "accept_personal": {
                "type": "boolean",
                "description": "A personal email address, i.e. tcooke1960@gmail.com"
              }
            },
            "additionalProperties": true
          },
          {
            "description": "Deprecated compatibility alias.",
            "anyOf": [
              {
                "type": "string",
                "minLength": 1
              },
              {
                "type": "array",
                "minItems": 1,
                "items": {
                  "type": "string",
                  "minLength": 1
                }
              }
            ]
          }
        ]
      },
      "callback_url": {
        "type": "string",
        "description": "URL to send the individual reveal update to. If not provided, the default webhook URL configured in your account settings will be used."
      },
      "reveal_options": {
        "type": "object",
        "description": "Optional advanced reveal options.",
        "properties": {
          "fair_key": {
            "type": "string",
            "description": "> An optional key used to fairly distribute throughput across your own sub-groups (for example your end-users or lists). Reveals are dispatched round-robin across distinct `fair_key` values within your account's concurrency limit, so a burst from one sub-group can't starve the others. Use a stable identifier such as your internal user id or list id. If omitted, reveals from your account are dispatched in submission order."
          }
        },
        "additionalProperties": false
      },
      "linkedin_url": {
        "type": "string",
        "description": "Deprecated compatibility alias for individual_reveal.profile_url."
      },
      "profile_url": {
        "type": "string",
        "description": "Deprecated compatibility alias for individual_reveal.profile_url."
      },
      "email": {
        "type": "string",
        "description": "Deprecated compatibility alias for individual_reveal.email."
      },
      "full_name": {
        "type": "string",
        "description": "Deprecated compatibility alias for individual_reveal.full_name.",
        "aliases": [
          "fullName"
        ]
      },
      "first_name": {
        "type": "string",
        "description": "Deprecated compatibility alias used with last_name to build individual_reveal.full_name."
      },
      "last_name": {
        "type": "string",
        "description": "Deprecated compatibility alias used with first_name to build individual_reveal.full_name."
      },
      "company_name": {
        "type": "string",
        "description": "Deprecated compatibility alias for individual_reveal.company."
      },
      "company_domain": {
        "type": "string",
        "description": "Deprecated compatibility alias for individual_reveal.domain."
      }
    },
    "required": [],
    "additionalProperties": true
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.id` | `number \| string` | No | — | — |
| `result.data.status` | `string` | No | — | — |
| `result.data.enrichment_level` | `string` | No | — | — |
| `result.data.is_complete` | `boolean` | No | — | — |
| `result.data.name` | `string` | No | — | — |
| `result.data.full_name` | `string` | No | — | — |
| `result.data.title` | `string` | No | — | — |
| `result.data.location` | `string` | No | — | — |
| `result.data.linkedin_profile_url` | `string` | No | — | — |
| `result.data.linkedin_url` | `string` | No | — | — |
| `result.data.email` | `string \| null` | No | — | — |
| `result.data.email_type` | `string \| null` | No | — | — |
| `result.data.email_status` | `string \| null` | No | — | — |
| `result.data.personal_email1` | `string \| null` | No | — | — |
| `result.data.personal_email2` | `string \| null` | No | — | — |
| `result.data.personal_email3` | `string \| null` | No | — | — |
| `result.data.emails` | `array` | No | — | — |
| `result.data.emails[].email` | `string` | No | — | — |
| `result.data.emails[].type` | `string` | No | — | — |
| `result.data.emails[].email_type` | `string` | No | — | — |
| `result.data.emails[].status` | `string` | No | — | — |
| `result.data.emails[].email_status` | `string` | No | — | — |
| `result.data.phone_number` | `string \| null` | No | — | — |
| `result.data.mobile_phone` | `string \| null` | No | — | — |
| `result.data.phone_number1` | `string \| null` | No | — | — |
| `result.data.mobile_phone1` | `string \| null` | No | — | — |
| `result.data.phone_number2` | `string \| null` | No | — | — |
| `result.data.phone_number3` | `string \| null` | No | — | — |
| `result.data.other_phone1` | `string \| null` | No | — | — |
| `result.data.phone_status` | `string \| null` | No | — | — |
| `result.data.phones` | `array` | No | — | — |
| `result.data.phones[].number` | `string` | No | — | — |
| `result.data.phones[].number_pretty` | `string` | No | — | — |
| `result.data.phones[].type` | `string` | No | — | — |
| `result.data.company` | `string` | No | — | — |
| `result.data.company_domain` | `string` | No | — | — |
| `result.data.company_industry` | `string` | No | — | — |
| `result.data.company_size_range` | `string` | No | — | — |
| `result.data.company_type` | `string` | No | — | — |
| `result.data.polling_timed_out` | `boolean` | No | — | — |
| `result.data.polling_attempts` | `integer` | No | — | — |
| `result.data.polling_message` | `string` | No | — | — |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "id": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "string"
              }
            ]
          },
          "status": {
            "type": "string"
          },
          "enrichment_level": {
            "type": "string"
          },
          "is_complete": {
            "type": "boolean"
          },
          "name": {
            "type": "string"
          },
          "full_name": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "location": {
            "type": "string"
          },
          "linkedin_profile_url": {
            "type": "string"
          },
          "linkedin_url": {
            "type": "string"
          },
          "email": {
            "type": [
              "string",
              "null"
            ]
          },
          "email_type": {
            "type": [
              "string",
              "null"
            ]
          },
          "email_status": {
            "type": [
              "string",
              "null"
            ]
          },
          "personal_email1": {
            "type": [
              "string",
              "null"
            ]
          },
          "personal_email2": {
            "type": [
              "string",
              "null"
            ]
          },
          "personal_email3": {
            "type": [
              "string",
              "null"
            ]
          },
          "emails": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "email": {
                  "type": "string"
                },
                "type": {
                  "type": "string"
                },
                "email_type": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "email_status": {
                  "type": "string"
                }
              },
              "additionalProperties": true
            }
          },
          "phone_number": {
            "type": [
              "string",
              "null"
            ]
          },
          "mobile_phone": {
            "type": [
              "string",
              "null"
            ]
          },
          "phone_number1": {
            "type": [
              "string",
              "null"
            ]
          },
          "mobile_phone1": {
            "type": [
              "string",
              "null"
            ]
          },
          "phone_number2": {
            "type": [
              "string",
              "null"
            ]
          },
          "phone_number3": {
            "type": [
              "string",
              "null"
            ]
          },
          "other_phone1": {
            "type": [
              "string",
              "null"
            ]
          },
          "phone_status": {
            "type": [
              "string",
              "null"
            ]
          },
          "phones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "number": {
                  "type": "string"
                },
                "number_pretty": {
                  "type": "string"
                },
                "type": {
                  "type": "string"
                }
              },
              "additionalProperties": true
            }
          },
          "company": {
            "type": "string"
          },
          "company_domain": {
            "type": "string"
          },
          "company_industry": {
            "type": "string"
          },
          "company_size_range": {
            "type": "string"
          },
          "company_type": {
            "type": "string"
          },
          "polling_timed_out": {
            "type": "boolean"
          },
          "polling_attempts": {
            "type": "integer"
          },
          "polling_message": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `per_result` (per result).
* Estimated Deepline credits: `0.35` per pricing unit.

## Related documentation

* [Wiza provider guide](https://deepline.com/docs/providers/wiza/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.