Skip to main content

Integrating with Clay

Send the companies in a segment, and their contacts if you want, to a Clay table as they visit your website.

Written by Oskar Johnson Hägglund

A Clay connector sends each company in a segment you choose to a table in Clay, as soon as the visit is processed. Clay receives it through the table's webhook and adds it as a new row, so you can enrich it and run your Clay workflows on it.

Before you start, you need:

  • A Clay account and a Clay table with a webhook source.

  • The Professional plan. If Clay has an Upgrade badge in the Send Data to Integration window, your plan doesn't include it: upgrade to Professional or contact us via the chat.

Step 1: Get the webhook URL from Clay

  1. In a Clay workbook, add a new table with a webhook source. Clay's steps are in its webhook integration guide.

  2. Copy the webhook URL Clay shows for the table.

  3. If you want only Albacross to be able to add rows, add an auth token to the webhook in Clay and copy it straight away. Clay shows the token only once.

Step 2: Create the connector

  1. In the sidebar, click Connectors, then Create Connector.

  2. In Send Data to Integration, choose Clay. There is nothing to sign in to: the form opens straight away.

Step 3: Set up the connector

Under General:

  1. Give the connector a Connector name.

  2. Paste the Clay webhook URL into URL. It has to be a clay.com address. Anything else shows Provided value is not a Clay webhook URL.

  3. Under Security options, keep Include security token ticked and paste the token from Clay into Clay auth token. Albacross sends it with every request in the x-clay-webhook-auth header, which is where Clay looks for it. If your Clay webhook has no token, untick Include security token.

Under Conditions:

  1. Pick the Segment whose companies you want in Clay. To create or change a segment, go to Website Visitors → Segments.

  2. Under What do you want to do?, choose Send only new companies or Send new and returning companies. Clay adds a new row for every request, so with returning companies the same company can appear in your table more than once.

Under Output:

  1. Under Type of data, choose Company, Contacts (email) or Contacts (email + phone).

  2. With contacts, set the Contact settings: how many contacts per company, keywords or a buyer persona, which countries, and the conditions (for example Don't export a company if no contact matches). Contacts use your email and phone credits. See How do email and phone credits work?

  3. Open Clay Template opens a ready-made Clay table in a new tab, if you'd rather start from it than build your own. It has a Webhook column for the incoming data and one column per company field Albacross sends: company name, country, registration number, website, industry and NACE code, year founded, links to the company's profile and contacts in Albacross, address, company phone, employee and revenue ranges, pages visited, total visits, visit duration and the time of the last visit.

  4. Click Save changes.

A connector only sends companies that match the segment after you save it. To send companies that were already in the segment, open the segment, click Export and pick the connector.

What Clay receives

Each company is one POST request with a JSON body, the same as the Default format of a Webhook connector: company name, website, country, address, industry, employees, revenue, social links, visits, duration, pages visited, UTM values, tags, links to the company's Albacross profile and its contacts, and contacts with the people you asked for. type is new for a first send and update for a returning company. For an example of the full body, see Integrating with Webhooks.

Clay has to accept each request within the timeout, the same as a webhook endpoint. See Webhook delivery: timeouts and retries. Clay also limits how many requests one webhook can take. When a table's webhook is full, create a new webhook in Clay and paste its URL into the connector.

Manage the connector

Your connector is listed under Connectors. Click the Clay filter to see only these. Click a connector to edit it, or open the ⋮ menu on its row to Pause or Resume it, Duplicate it, Send example (a sample company sent to your Clay table, to check your setup) or Remove it.

To see what the connector sent and whether it worked, open its Activity Log. See The Activity Log: what your connectors sent.

Did this answer your question?