← Clearbit

Email lookup with Clearbit API

Pipedream makes it easy to connect APIs for Clearbit and 900+ other apps remarkably fast.

Trigger workflow on
HTTP requests, schedules and app events
Next, do this
Email lookup with the Clearbit API
No credit card required
Into to Pipedream
Watch us build a workflow
Watch us build a workflow
7 min
Watch now ➜
Trusted by 250,000+ developers from startups to Fortune 500 companies:
Trusted by 250,000+ developers from startups to Fortune 500 companies

Developers Pipedream

Getting Started

Create a workflow to Email lookup with the Clearbit API. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

  1. Configure the Email lookup action
    1. Connect your Clearbit account
    2. Configure Email
    3. Optional- Configure Webhook URL
    4. Optional- Configure Given Name
    5. Optional- Configure Family Name
    6. Optional- Configure IP Address
    7. Optional- Configure Location
    8. Optional- Configure Company
    9. Optional- Configure Company Domain
    10. Optional- Configure LinkedIn
    11. Optional- Configure Twitter
    12. Optional- Configure Facebook
    13. Optional- Configure Handle lack of records found as an error?
  2. Select a trigger to run your workflow on HTTP requests, schedules or app events
  3. Deploy the workflow
  4. Send a test event to validate your setup
  5. Turn on the trigger

Integrations

Email lookup with Clearbit API on New Requests (Payload Only) from HTTP / Webhook API
HTTP / Webhook + Clearbit
 
Try it
Email lookup with Clearbit API on New Item in Feed from RSS API
RSS + Clearbit
 
Try it
Email lookup with Clearbit API on New Message from Discord API
Discord + Clearbit
 
Try it
Email lookup with Clearbit API on New Message In Channels from Slack API
Slack + Clearbit
 
Try it
Email lookup with Clearbit API on New Message in Channel from Discord Bot API
Discord Bot + Clearbit
 
Try it

Details

This is a pre-built, open source component from Pipedream's GitHub repo. The component is developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Email lookup on Clearbit
Description:This endpoint retrieves a person by email address. [See the docs here](https://dashboard.clearbit.com/docs#enrichment-api-person-api-email-lookup)
Version:0.4.0
Key:clearbit-email-lookup

Code

import app from "../../clearbit.app.mjs";

export default {
  key: "clearbit-email-lookup",
  name: "Email lookup",
  description: "This endpoint retrieves a person by email address. [See the docs here](https://dashboard.clearbit.com/docs#enrichment-api-person-api-email-lookup)",
  version: "0.4.0",
  type: "action",
  props: {
    app,
    email: {
      propDefinition: [
        app,
        "email",
      ],
    },
    webhookUrl: {
      propDefinition: [
        app,
        "webhookUrl",
      ],
    },
    givenName: {
      label: "Given Name",
      type: "string",
      description: "First name of person.",
      optional: true,
    },
    familyName: {
      label: "Family Name",
      type: "string",
      description: "Last name of person. If you have this, passing this is strongly recommended to improve match rates.",
      optional: true,
    },
    ipAddress: {
      label: "IP Address",
      type: "string",
      description: "IP address of the person. If you have this, passing this is strongly recommended to improve match rates.",
      optional: true,
    },
    location: {
      label: "Location",
      type: "string",
      description: "The city or country where the person resides.",
      optional: true,
    },
    company: {
      label: "Company",
      type: "string",
      description: "The name of the person's employer.",
      optional: true,
    },
    companyDomain: {
      label: "Company Domain",
      type: "string",
      description: "The domain for the person's employer.",
      optional: true,
    },
    linkedin: {
      propDefinition: [
        app,
        "linkedin",
      ],
      description: "The LinkedIn URL for the person.",
    },
    twitter: {
      propDefinition: [
        app,
        "twitter",
      ],
      description: "The Twitter handle for the person.",
    },
    facebook: {
      propDefinition: [
        app,
        "facebook",
      ],
      description: "The Facebook URL for the person.",
    },
    errorIfNoRecords: {
      propDefinition: [
        app,
        "errorIfNoRecords",
      ],
    },
  },
  async run({ $ }) {
    try {
      const res = await this.app.emailLookup($, {
        email: this.email,
        webhook_url: this.webhookUrl,
        given_name: this.givenName,
        family_name: this.familyName,
        ip_address: this.ipAddress,
        location: this.location,
        company: this.company,
        company_domain: this.companyDomain,
        linkedin: this.linkedin,
        twitter: this.twitter,
        facebook: this.facebook,
      });
      $.export("$summary", "Successfully looked up email.");
      return res;
    } catch (err) {
      if (!this.errorIfNoRecords && err.response?.status == 404) {
        $.export("$summary", "No person found.");
      } else {
        throw err;
      }
    }
  },
};

Configuration

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.
LabelPropTypeDescription
ClearbitappappThis component uses the Clearbit app.
Emailemailstring

The email address to look up.

Webhook URLwebhookUrlstring

A webhook URL that results will be sent to.

Given NamegivenNamestring

First name of person.

Family NamefamilyNamestring

Last name of person. If you have this, passing this is strongly recommended to improve match rates.

IP AddressipAddressstring

IP address of the person. If you have this, passing this is strongly recommended to improve match rates.

Locationlocationstring

The city or country where the person resides.

Companycompanystring

The name of the person's employer.

Company DomaincompanyDomainstring

The domain for the person's employer.

LinkedInlinkedinstring

The LinkedIn URL for the person.

Twittertwitterstring

The Twitter handle for the person.

Facebookfacebookstring

The Facebook URL for the person.

Handle lack of records found as an error?errorIfNoRecordsboolean

Defaults to false. If false and no records are found, the step will still be considered a success. If true and no records are found, the step will return an error and workflow execution will stop.

Authentication

Clearbit uses API keys for authentication. When you connect your Clearbit account, Pipedream securely stores the keys so you can easily authenticate to Clearbit APIs in both code and no-code steps.

Copy your "secret API key" from your Clearbit account here and paste it below.

About Clearbit

B2B Lead Data Enrichment, Qualification & Scoring

More Ways to Use Clearbit

Actions

Company Name to Domain with the Clearbit API

The Company Name to Domain action lets you convert the exact name of a company to a website domain, and a logo. See the docs here.

 
Try it
Domain lookup with the Clearbit API

The Company API allows you to look up a company by their domain. See the docs here.

 
Try it
Find Companies with the Clearbit API

Find companies via specific criteria. See the docs here

 
Try it
Find Contacts with the Clearbit API

Find people who work at a specific company. See the docs here

 
Try it