> ## 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.

# ZoomInfo: Enrich Contact

> Enrich contacts with ZoomInfo data such as work email, job title, and company. Includes SDK V2 examples, input constraints, response fields, and Deepline cost.

Enrich contacts with ZoomInfo data such as work email, job title, and company.

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

## 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(
  'zoominfo_enrich_contact',
  {
    "data": {
      "type": "ContactEnrich",
      "attributes": {
        "outputFields": [
          "city"
        ],
        "matchPersonInput": [
          {
            "personId": 123,
            "fullName": "Example",
            "firstName": "Jane"
          }
        ]
      }
    }
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute zoominfo_enrich_contact --input '{
  "data": {
    "type": "ContactEnrich",
    "attributes": {
      "outputFields": [
        "city"
      ],
      "matchPersonInput": [
        {
          "personId": 123,
          "fullName": "Example",
          "firstName": "Jane"
        }
      ]
    }
  }
}' --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": {
    "data": [
      {
        "id": "id_123",
        "type": "Contact",
        "attributes": {}
      }
    ]
  }
}
```

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

## Input reference

Contact enrich request.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.data` | `object` | Yes | — | Contact enrich request resource. |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Contact enrich request.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Contact enrich request resource.",
        "properties": {
          "type": {
            "type": "string",
            "description": "The type of the resource",
            "default": "ContactEnrich",
            "pattern": "ContactEnrich"
          },
          "attributes": {
            "type": "object",
            "description": "Contact enrich request attributes.",
            "properties": {
              "outputFields": {
                "type": "array",
                "description": "Specifies the fields to include in the response. To request company-related fields for a contact, use camel-case field names corresponding to the company object (e.g., companyName, companyPhone, companyId, companyRevenue).",
                "items": {
                  "type": "string",
                  "enum": [
                    "city",
                    "companyAlternateLogos",
                    "companyCity",
                    "companyContinent",
                    "companyCountry",
                    "companyDescription",
                    "companyDivision",
                    "companyEmployeeCount",
                    "companyEmployeeGrowth",
                    "companyEmployeeRange",
                    "companyFax",
                    "companyId",
                    "companyIndustries",
                    "companyIndustryCodes",
                    "companyLogo",
                    "companyNaicsCodes",
                    "companyName",
                    "companyPhone",
                    "companyPrimaryIndustry",
                    "companyPrimaryIndustryCode",
                    "companyPrimarySubIndustryCode",
                    "companyRanking",
                    "companyRevenue",
                    "companyRevenueNumeric",
                    "companyRevenueRange",
                    "companySicCodes",
                    "companySocialMediaUrls",
                    "companyState",
                    "companyStreet",
                    "companyTicker",
                    "companyType",
                    "companyWebsite",
                    "companyZipCode",
                    "contactAccuracyScore",
                    "continent",
                    "country",
                    "directPhoneAlt",
                    "directPhoneDoNotCall",
                    "education",
                    "email",
                    "emailAlt",
                    "employmentHistory",
                    "engagements",
                    "externalUrls",
                    "firstName",
                    "hasCanadianEmail",
                    "hashedEmails",
                    "id",
                    "isDefunct",
                    "jobFunction",
                    "jobTitle",
                    "lastName",
                    "lastUpdatedDate",
                    "locationCompanyId",
                    "managementLevel",
                    "metroArea",
                    "middleName",
                    "mobilePhone",
                    "mobilePhoneAlt",
                    "mobilePhoneDoNotCall",
                    "noticeProvidedDate",
                    "personHasMoved",
                    "phone",
                    "picture",
                    "positionStartDate",
                    "region",
                    "salutation",
                    "state",
                    "street",
                    "suffix",
                    "supplementalEmail",
                    "techSkills",
                    "validDate",
                    "withinCalifornia",
                    "withinCanada",
                    "withinEu",
                    "yearsOfExperience",
                    "zipCode"
                  ]
                }
              },
              "requiredFields": {
                "type": "array",
                "description": "List of fields that are required for the match.",
                "items": {
                  "type": "string"
                }
              },
              "matchPersonInput": {
                "type": "array",
                "description": "List of matchPersonInput.",
                "minItems": 1,
                "maxItems": 25,
                "items": {
                  "type": "object",
                  "description": "The Enrich API provides the ability to enrich contact and company data with ZoomInfo's proprietary data.",
                  "properties": {
                    "personId": {
                      "type": "integer",
                      "description": "Unique ZoomInfo identifier for the contact.",
                      "format": "int64"
                    },
                    "fullName": {
                      "type": "string",
                      "description": "Contact full name."
                    },
                    "firstName": {
                      "type": "string",
                      "description": "Contact first name."
                    },
                    "lastName": {
                      "type": "string",
                      "description": "Contact last name."
                    },
                    "emailAddress": {
                      "type": "string",
                      "description": "Email address for the contact in example@example.com format."
                    },
                    "phone": {
                      "type": "string",
                      "description": "Contact direct or mobile phone number."
                    },
                    "jobTitle": {
                      "type": "string",
                      "description": "Contact title at current place of employment."
                    },
                    "hashedEmail": {
                      "type": "string",
                      "description": "Hashed email value for the contact. Allows matching via an email address with the extra security of not exposing the email. Supported hash algorithms are: MD5, SHA1, SHA256 and SHA512."
                    },
                    "externalURL": {
                      "type": "string",
                      "description": "Social media URLs for the contact (e.g., Facebook, Twitter, LinkedIn)."
                    },
                    "lastUpdatedDateAfter": {
                      "type": "string",
                      "description": "The date after which the contact's profile was last updated. Uses YYYY-MM-DD format.",
                      "format": "date"
                    },
                    "validDateAfter": {
                      "type": "string",
                      "description": "The date after which the contact's profile was last validated. Uses YYYY-MM-DD format.",
                      "format": "date"
                    },
                    "contactAccuracyScoreMin": {
                      "type": "string",
                      "description": "Minimum accuracy score for enrich result. This score indicates the likelihood that a contact is reachable and still employed by the company listed. Minimum score is 70 and maximum is 99."
                    },
                    "companyId": {
                      "type": "integer",
                      "description": "Unique ZoomInfo identifier for a company.",
                      "format": "int64"
                    },
                    "companyName": {
                      "type": "string",
                      "description": "Company name."
                    }
                  },
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "outputFields",
              "matchPersonInput"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "type",
          "attributes"
        ],
        "additionalProperties": false
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Contact enrich response. |
| `result.data.data` | `array` | Yes | — | The primary data of the document |
| `result.data.data[].id` | `string` | Yes | — | The unique identifier for the resource |
| `result.data.data[].type` | `string` | Yes | `"Contact"` | The type of the resource |
| `result.data.data[].attributes` | `object` | Yes | — | Contact enrich response attributes. |
| `result.data.data[].attributes.firstName` | `string` | No | — | Contact first name. |
| `result.data.data[].attributes.middleName` | `string` | No | — | Contact middle name. |
| `result.data.data[].attributes.lastName` | `string` | No | — | Contact last name. |
| `result.data.data[].attributes.email` | `string` | No | — | Work email address for the contact in [example@example.com](mailto:example@example.com) format. |
| `result.data.data[].attributes.hasCanadianEmail` | `boolean` | No | — | Indicates whether the contact's email address is associated with a Canada domain. |
| `result.data.data[].attributes.supplementalEmail` | `string` | No | — | Supplemental email address for the contact in [example@example.com](mailto:example@example.com) format. |
| `result.data.data[].attributes.phone` | `string` | No | — | Contact direct phone number. |
| `result.data.data[].attributes.directPhoneDoNotCall` | `boolean` | No | — | Contact flagged with do not call for direct phone. |
| `result.data.data[].attributes.street` | `string` | No | — | Street portion of the contact's work address. |
| `result.data.data[].attributes.city` | `string` | No | — | City portion of the contact's work address. |
| `result.data.data[].attributes.region` | `string` | No | — | State or province of the contact's work address. |
| `result.data.data[].attributes.metroArea` | `string` | No | — | Metro area of the contact's work address. |
| `result.data.data[].attributes.zipCode` | `string` | No | — | Zip code or postal code of the contact's work address. |
| `result.data.data[].attributes.state` | `string` | No | — | State or province of the contact's work address. |
| `result.data.data[].attributes.country` | `string` | No | — | Country of the contact's work address. |
| `result.data.data[].attributes.continent` | `string` | No | — | Continent of the contact's work address. |
| `result.data.data[].attributes.personHasMoved` | `string` | No | — | Indicates ZoomInfo recognizes the contact does not match ZoomInfo's current company but does match known employment history. |
| `result.data.data[].attributes.withinEu` | `boolean` | No | — | Indicates whether the contact's work address is in Europe. |
| `result.data.data[].attributes.withinCalifornia` | `boolean` | No | — | Indicates whether the contact's work address is in California. |
| `result.data.data[].attributes.withinCanada` | `boolean` | No | — | Indicates whether the contact's work address is in Canada. |
| `result.data.data[].attributes.validDate` | `string` | No | — | Date on which the contact record was last validated. |
| `result.data.data[].attributes.lastUpdatedDate` | `string` | No | — | Date on which the contact record was last updated. |
| `result.data.data[].attributes.noticeProvidedDate` | `string` | No | — | Date on which the contact was notified of inclusion in ZoomInfo's database. Uses YYYY-MM-DD format. |
| `result.data.data[].attributes.salutation` | `string` | No | — | Contact salutation. |
| `result.data.data[].attributes.suffix` | `string` | No | — | Contact suffix. |
| `result.data.data[].attributes.jobTitle` | `string` | No | — | Contact job title at current place of employment. |
| `result.data.data[].attributes.jobFunction` | `object` | No | — | Contact job function at current place of employment. |
| `result.data.data[].attributes.jobFunction.name` | `string` | No | — | Name of the job function. |
| `result.data.data[].attributes.jobFunction.department` | `string` | No | — | Department associated with the job function. |
| `result.data.data[].attributes.education` | `array` | No | — | Contact education details. |
| `result.data.data[].attributes.education[].school` | `string` | No | — | School name. |
| `result.data.data[].attributes.education[].educationDegree` | `object` | No | — | Education degree for match |
| `result.data.data[].attributes.education[].educationDegree.degree` | `string` | No | — | Degree type (e.g., Bachelor of Science, Master of Arts, Doctor of Philosophy). |
| `result.data.data[].attributes.education[].educationDegree.areaOfStudy` | `string` | No | — | Area of study for the degree (e.g., Computer Science, Business Administration, Economics). |
| `result.data.data[].attributes.hashedEmails` | `array` | No | — | Contact MD5 encrypted email address(es). |
| `result.data.data[].attributes.picture` | `string` | No | — | The URL which can be used to retrieve a photo for the contact. |
| `result.data.data[].attributes.techSkills` | `array` | No | — | List of technology skills identified for a contact. |
| `result.data.data[].attributes.techSkills[].id` | `string` | No | — | Unique identifier for the technology skill. |
| `result.data.data[].attributes.techSkills[].name` | `string` | No | — | Name of the technology skill. |
| `result.data.data[].attributes.mobilePhone` | `string` | No | — | Contact mobile phone. |
| `result.data.data[].attributes.mobilePhoneDoNotCall` | `boolean` | No | — | Contact flagged with do not call for mobile phone. |
| `result.data.data[].attributes.directPhoneAlt` | `array` | No | — | Alternative direct phone numbers with their sources, providing multiple direct phone options from different data sources. |
| `result.data.data[].attributes.directPhoneAlt[].value` | `string` | No | — | The phone number or email address value. |
| `result.data.data[].attributes.directPhoneAlt[].source` | `string` | No | — | The source identifier indicating which data source provided this value. |
| `result.data.data[].attributes.mobilePhoneAlt` | `array` | No | — | Alternative mobile phone numbers with their sources, providing multiple mobile phone options from different data sources. |

The table shows the first 50 fields. Use the live contract below for every field.

> [!NOTE]
>
> This output schema is too large for an inline display. Read the complete live contract with `deepline describe zoominfo_enrich_contact --json`.

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [ZoomInfo provider guide](https://deepline.com/docs/providers/zoominfo/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.