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

# Connect Your PDL API Key to Clay

> Add your People Data Labs API key to Clay and reuse it across your Clay workflows.

You can add your People Data Labs API key to Clay in two ways:

* **Through Workspace Settings:** Add your API key to your Clay workspace before building a workflow.
* **From the Enrichment Panel:** Add your API key while you're already setting up a PDL enrichment in a table.

Both methods save the connection to your Clay workspace, so you can reuse it across other tables and workflows.

<Note>
  You don't need your own PDL API key to use People Data Labs in Clay. Clay also provides managed PDL connections that work out of the box.

  See the [FAQs](#faqs) below for the differences between Clay-managed connections and using your own PDL API key.
</Note>

## Before you start

You'll need a PDL API key. You can find your API keys in the [PDL dashboard](https://www.peopledatalabs.com/).

<Warning>
  Keep your API key private. **Do not paste it into a Clay table cell.** Add it only through Clay's connection settings or the enrichment setup panel.
</Warning>

***

## Method 1: Add your API key through Workspace Settings

Use this method if you want to set up your PDL connection before building a workflow. Once saved, the connection can be reused across your Clay tables and workflows.

<Steps>
  <Step title="Open your Clay workspace settings">
    <Columns cols={2}>
      <Column>
        Sign in to your Clay workspace. Click your profile picture or workspace name, then select **Settings**.
      </Column>

      <Frame caption="Open Clay workspace settings">
        <img src="https://mintcdn.com/peopledatalabs/osiSgeIkaWli_Kwv/images/docs/clay-settings.png?fit=max&auto=format&n=osiSgeIkaWli_Kwv&q=85&s=e526502bbdfe12e025020a4c660f1f22" alt="Opening workspace settings in Clay" width="2910" height="1892" data-path="images/docs/clay-settings.png" />
      </Frame>
    </Columns>
  </Step>

  <Step title="Open Connections">
    <Columns cols={2}>
      <Column>
        Select **Connections** from the settings navigation.
      </Column>

      <Frame caption="Open Connections">
        <img src="https://mintcdn.com/peopledatalabs/osiSgeIkaWli_Kwv/images/docs/clay-connections.png?fit=max&auto=format&n=osiSgeIkaWli_Kwv&q=85&s=6f6b4a127fdfe1b1bf3a22857550d7e2" alt="Opening Connections in Clay workspace settings" width="2910" height="1892" data-path="images/docs/clay-connections.png" />
      </Frame>
    </Columns>
  </Step>

  <Step title="Create a connection">
    <Columns cols={2}>
      <Column>
        Click **Create**, then search for **People Data Labs**.
      </Column>

      <Column>
        <Frame caption="Create a new connection">
          <img src="https://mintcdn.com/peopledatalabs/osiSgeIkaWli_Kwv/images/docs/clay-select-pdl-connection.png?fit=max&auto=format&n=osiSgeIkaWli_Kwv&q=85&s=be600f15a207a4051ff6150c0fd3bbea" alt="Searching for People Data Labs in Clay Connections" width="2910" height="1892" data-path="images/docs/clay-select-pdl-connection.png" />
        </Frame>

        <Frame caption="Search connections for People Data Labs">
          <img src="https://mintcdn.com/peopledatalabs/osiSgeIkaWli_Kwv/images/docs/clay-connections-search.png?fit=max&auto=format&n=osiSgeIkaWli_Kwv&q=85&s=c0ee9733f5bd07c0ef95763c83a86584" alt="Opening Connections in Clay workspace settings" width="2910" height="1892" data-path="images/docs/clay-connections-search.png" />
        </Frame>
      </Column>
    </Columns>

    <Info>
      You'll see multiple People Data Labs connection options. Choose the PDL product or products you want to use.

      See [Why are there multiple People Data Labs connection options?](#why-are-there-multiple-people-data-labs-connection-options) for more information.
    </Info>
  </Step>

  <Step title="Add your PDL API key">
    <Columns cols={2}>
      <Column>
        In the connection form:

        1. Enter a name for the connection.
        2. Paste your PDL API key.
        3. Select whether to save this as the default API key for this connection.
      </Column>

      <Frame caption="Add your PDL API key">
        <img src="https://mintcdn.com/peopledatalabs/osiSgeIkaWli_Kwv/images/docs/clay-save-pdl-connection.png?fit=max&auto=format&n=osiSgeIkaWli_Kwv&q=85&s=c7611511c20450117e81ad2dc8fd1db8" alt="Entering a People Data Labs API key in Clay" width="2910" height="1892" data-path="images/docs/clay-save-pdl-connection.png" />
      </Frame>
    </Columns>

    <Tip>
      Use a name that will help you distinguish this connection from Clay-managed PDL connections or from other PDL API keys you may add.
    </Tip>
  </Step>

  <Step title="Save the connection">
    <Columns cols={2}>
      <Column>
        Click **Save**.
      </Column>

      <Frame caption="Save your PDL connection">
        <img src="https://mintcdn.com/peopledatalabs/osiSgeIkaWli_Kwv/images/docs/clay-pdl-connection-saved.png?fit=max&auto=format&n=osiSgeIkaWli_Kwv&q=85&s=4a58396f7e4071071272d2cd3794381b" alt="Saved People Data Labs connection in Clay" width="2910" height="1892" data-path="images/docs/clay-pdl-connection-saved.png" />
      </Frame>
    </Columns>

    🎉 Your PDL connection is now available in your Clay workspace and can be selected when you configure supported PDL enrichments in your workflows.
  </Step>
</Steps>

***

## Method 2: Add your API key from the Enrichment Panel

If you're already working in a Clay table, you can add a PDL API key while setting up an enrichment.

This creates the same workspace-level connection as Method 1. After you save it, you can reuse the connection in other tables and workflows.

<Steps>
  <Step title="Add an enrichment">
    <Columns cols={2}>
      <Column>
        Open a Clay table and click **Add Column**, then select **Add enrichment**.
      </Column>

      <Column>
        <Frame caption="Open a Clay Table">
          <img src="https://mintcdn.com/peopledatalabs/osiSgeIkaWli_Kwv/images/docs/clay-add-enrichment1.png?fit=max&auto=format&n=osiSgeIkaWli_Kwv&q=85&s=9954e4100883167537ccf38f7ffe9ece" alt="Adding an enrichment to a Clay table" width="2910" height="1892" data-path="images/docs/clay-add-enrichment1.png" />
        </Frame>

        <Frame caption="Add a column">
          <img src="https://mintcdn.com/peopledatalabs/osiSgeIkaWli_Kwv/images/docs/clay-add-enrichment2.png?fit=max&auto=format&n=osiSgeIkaWli_Kwv&q=85&s=d98a2894da144454f274f119b0667cbc" alt="Adding an enrichment to a Clay table" width="2910" height="1892" data-path="images/docs/clay-add-enrichment2.png" />
        </Frame>

        <Frame caption="Add an enrichment">
          <img src="https://mintcdn.com/peopledatalabs/osiSgeIkaWli_Kwv/images/docs/clay-add-enrichment3.png?fit=max&auto=format&n=osiSgeIkaWli_Kwv&q=85&s=5f39cdb946147e7ae7a608ed68bfb78f" alt="Adding an enrichment to a Clay table" width="2910" height="1892" data-path="images/docs/clay-add-enrichment3.png" />
        </Frame>
      </Column>
    </Columns>
  </Step>

  <Step title="Choose a People Data Labs action">
    <Columns cols={2}>
      <Column>
        Search for **People Data Labs** and select the enrichment action you want to add to your table.
      </Column>

      <Column>
        <Frame caption="Search for People Data Labs">
          <img src="https://mintcdn.com/peopledatalabs/osiSgeIkaWli_Kwv/images/docs/clay-add-enrichment5.png?fit=max&auto=format&n=osiSgeIkaWli_Kwv&q=85&s=673f5ce2d8d281d5a305bcd6812a4c3b" alt="Search for People Data Labs in the Enrichment Selection Menu" width="2910" height="1892" data-path="images/docs/clay-add-enrichment5.png" />
        </Frame>

        <Frame caption="Select the People Data Labs Provider option">
          <img src="https://mintcdn.com/peopledatalabs/osiSgeIkaWli_Kwv/images/docs/clay-add-enrichment6.png?fit=max&auto=format&n=osiSgeIkaWli_Kwv&q=85&s=398bd56d64b6f1f71aa90b7c96198678" alt="Search for People Data Labs in the Enrichment Selection Menu" width="2910" height="1892" data-path="images/docs/clay-add-enrichment6.png" />
        </Frame>
      </Column>
    </Columns>
  </Step>

  <Step title="Add an account">
    <Columns cols={2}>
      <Column>
        In the enrichment setup panel, open the **Account** menu and select **Manage accounts +**.
      </Column>

      <Frame caption="Add an account">
        <img src="https://mintcdn.com/peopledatalabs/osiSgeIkaWli_Kwv/images/docs/clay-add-enrichment7.png?fit=max&auto=format&n=osiSgeIkaWli_Kwv&q=85&s=1b554dd276a3021f70426fce8e462a28" alt="Adding a People Data Labs account from the Clay enrichment panel" width="2910" height="1892" data-path="images/docs/clay-add-enrichment7.png" />
      </Frame>
    </Columns>
  </Step>

  <Step title="Enter your API key">
    <Columns cols={2}>
      <Column>
        In the connection form:

        1. Enter a name for the connection.
        2. Paste your PDL API key.
        3. Select whether to save this as the default API key for this connection.
      </Column>

      <Frame caption="Enter your PDL API key">
        <img src="https://mintcdn.com/peopledatalabs/osiSgeIkaWli_Kwv/images/docs/clay-add-enrichmentX.png?fit=max&auto=format&n=osiSgeIkaWli_Kwv&q=85&s=434dc4469670177fc62eee18cccf636d" alt="Entering a People Data Labs API key in the Clay enrichment panel" width="2910" height="1892" data-path="images/docs/clay-add-enrichmentX.png" />
      </Frame>
    </Columns>

    <Tip>
      Use a name that will help you distinguish this connection from Clay-managed PDL connections or from other PDL API keys you may add.
    </Tip>
  </Step>

  <Step title="Save the connection">
    <Columns cols={2}>
      <Column>
        Click **Save**.
      </Column>

      <Frame caption="Use your saved PDL connection">
        <img src="https://mintcdn.com/peopledatalabs/osiSgeIkaWli_Kwv/images/docs/clay-add-enrichmentY.png?fit=max&auto=format&n=osiSgeIkaWli_Kwv&q=85&s=63a0f6180925d2e5161d0ac202d75f2e" alt="Selecting a saved People Data Labs connection for a Clay enrichment" width="2910" height="1892" data-path="images/docs/clay-add-enrichmentY.png" />
      </Frame>
    </Columns>

    🎉 Your PDL connection is now available in your Clay workspace and can be selected when you configure supported PDL enrichments in your workflows.
  </Step>
</Steps>

***

## FAQs

<AccordionGroup>
  <Accordion title="Why are there already People Data Labs connections set up for me?" icon="info">
    Clay provides managed People Data Labs connections out of the box, so you can use PDL enrichments without connecting your own API key.

    When you use a Clay-managed PDL connection, the enrichment uses Clay's PDL account and consumes Clay credits.

    If you connect your own PDL API key, the enrichment instead uses your PDL account and its available PDL API credits. You don't pay Clay credits for the PDL data used through your own connection.

    See [Clay Integration](/docs/clay-integration) for more information about the two options.
  </Accordion>

  <Accordion title="Why are there multiple People Data Labs connection options?" icon="info">
    Clay provides separate People Data Labs connections for different PDL products:

    **👤 Person (`People Data Labs`)**

    Use the Person connection when you want to enrich individual professionals with information about their identity, employment, education, and other professional attributes. Common use cases include sales prospecting and recruiting.

    **🏢 Company (`People Data Labs Company`)**

    Use the Company connection when you want to enrich organizations using information such as a company name or domain. This is useful for building firmographic profiles, qualifying accounts, and evaluating companies against your ideal customer profile.

    **🌐 IP (`People Data Labs - IP`)**

    Use the IP connection when you want to identify the company associated with an IP address. This can be useful for workflows such as identifying organizations visiting your website.

    You can configure any combination of these connections. Your PDL account must have the appropriate credits available for the PDL products you use.
  </Accordion>

  <Accordion title="Do I need a separate API key for each PDL connection?" icon="info">
    No. A single PDL API key can be used across multiple PDL products, including Person, Company, and IP, as long as your PDL account has the appropriate credits available.

    You can also create multiple PDL API keys if you want to separate usage across different workflows, teams, or PDL products.
  </Accordion>

  <Accordion title="Clay is using its managed PDL connection instead of mine" icon="info">
    Open the enrichment's **Account** menu and select the connection you created with your PDL API key.
  </Accordion>

  <Accordion title="I can't add a connection" icon="info">
    Check whether your Clay workspace permissions allow you to create connections.
  </Accordion>
</AccordionGroup>

For an overview of using People Data Labs in Clay, including the differences between Clay-managed connections and using your own PDL API key, see [Clay Integration](/docs/clay-integration).

For the full list of available PDL actions in Clay, see [Clay's People Data Labs integration guide](https://university.clay.com/docs/people-data-labs-integration-overview).


## Related topics

- [Clay Integration](/docs/clay-integration.md)
- [Data Delivery Using Direct Download](/docs/data-delivery-using-direct-download.md)
- [Salesforce Integration](/docs/salesforce-integration.md)
- [October 2021 Release Notes](/changelog/october-2021-release-notes-v16.md)
- [How To Authenticate Our APIs Within a Zap](/docs/authenticate-our-apis-within-a-zap.md)
