Skip to content

Fetch full contact emails

social • 3rd party API • integration

Enrich a dataset containing email addresses with personal information using the FullContact service.

API integration

To use this step your team needs to have the Full Contact integration configured in Graphext. The corresponding credentials are required to connect to a third-party API. You can configure API integrations following the INTEGRATIONS or ADD INTEGRATION link in the top-left corner of your Team's page, selecting API keys, and then the name of the desired third-party service.

To enable the Full Contact integration in particular you will need access to Full Contact's service. Follow the instructions here to create the required API key.

Usage

The following are the step's expected inputs and outputs and their specific types.

Step signature
fetch_full_contact_emails(email: category, {"param": value}) -> (
    fullName: category,
    age: number,
    gender: category,
    location: category,
    title: category,
    organization: category,
    twitter: category,
    linkedin: category,
    facebook: category,
    bio: text,
    avatar: url,
    website: url,
    given_name: category,
    family_name: category,
    education_institution: category,
    education_degree: category
)

where the object {"param": value} is optional in most cases and if present may contain any of the parameters described in the corresponding section below.

Example

The step has no configuration parameter, so it's simply

Example call (in recipe editor)
fetch_full_contact_emails(ds.email) -> (
  ds.fullName,
  ds.age,
  ds.gender,
  ds.location,
  ds.title,
  ds.organization,
  ds.twitter,
  ds.linkedin,
  ds.facebook,
  ds.bio,
  ds.avatar,
  ds.website,
  ds.given_name,
  ds.family_name,
  ds.education_institution,
  ds.education_degree
)

Inputs

email: column:category

Emails to fetch personal information for.

Outputs

fullName: column:category

Full name of the person.

age: column:number

Age of the person.

gender: column:category

Gender of the person (M/F).

location: column:category

Currently known location.

title: column:category

Current title the person holds at the organization.

organization: column:category

Current organization a person belongs to.

twitter: column:category

Twitter profile.

linkedin: column:category

LinkedIn profile.

facebook: column:category

Facebook profile.

bio: column:text

Biography as extracted from social media accounts.

avatar: column:url

Picture uses in social media accounts.

website: column:url

Personal website.

given_name: column:category

Person's given name.

family_name: column:category

Person's family name.

education_institution: column:category

Category containing the most relevant educational institution the person attended.

education_degree: column:category

Category representing the degree obtained at this institution.

Parameters

integration: string

ID of the integration you'd like to use.