> For the complete documentation index, see [llms.txt](https://whitepaper.aitech.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whitepaper.aitech.io/agentforge/tools/clay.md).

# clay

[Clay](https://www.clay.com/) is a data enrichment and workflow automation platform that helps teams streamline lead generation, research, and data operations through powerful integrations and flexible inputs.

Learn how to use the Clay Tool in Agent Forge to seamlessly insert data into a Clay workbook through webhook triggers. This tutorial walks you through setting up a webhook, configuring data mapping, and automating real-time updates to your Clay workbooks. Perfect for streamlining lead generation and data enrichment directly from your workflow!

{% embed url="<https://www.youtube.com/embed/cx_75X5sI_s>" %}

With Clay, you can:

* **Enrich agent outputs**: Automatically feed your Agent Forge agent data into Clay tables for structured tracking and analysis
* **Trigger workflows via webhooks**: Use Clay’s webhook support to initiate Agent Forge agent tasks from within Clay
* **Leverage data loops**: Seamlessly iterate over enriched data rows with agents that operate across dynamic datasets

In Agent Forge, the Clay integration allows your agents to push structured data into Clay tables via webhooks. This makes it easy to collect, enrich, and manage dynamic outputs such as leads, research summaries, or action items—all in a collaborative, spreadsheet-like interface. Your agents can populate rows in real time, enabling asynchronous workflows where AI-generated insights are captured, reviewed, and used by your team. Whether you're automating research, enriching CRM data, or tracking operational outcomes, Clay becomes a living data layer that interacts intelligently with your agents. By connecting Agent Forge with Clay, you gain a powerful way to operationalize agent results, loop over datasets with precision, and maintain a clean, auditable record of AI-driven work.

### Usage Instructions

Populate Clay workbook with data using a JSON or plain text. Enables direct communication and notifications with channel confirmation.

### Tools

#### `clay_populate`

Populate Clay with data from a JSON file. Enables direct communication and notifications with timestamp tracking and channel confirmation.

**Input**

| Parameter    | Type   | Required | Description                                |
| ------------ | ------ | -------- | ------------------------------------------ |
| `webhookURL` | string | Yes      | The webhook URL to populate                |
| `data`       | json   | Yes      | The data to populate                       |
| `authToken`  | string | Yes      | Auth token for Clay webhook authentication |

**Output**

| Parameter | Type | Description   |
| --------- | ---- | ------------- |
| `data`    | any  | Response data |

**Multiple Batch upload**

```json
[
  {
    "Company": "Northwind",
    "Website": "https://northwind.example",
    "Contact Name": "Alex Park",
    "Email": "alex@northwind.example",
    "Source": "Forge Research"
  },
  {
    "Company": "Globex",
    "Website": "https://globex.example",
    "Contact Name": "Sam Rivera",
    "Email": "sam@globex.example",
    "Score": 87
  }
]
```

### Notes

* Category: `tools`
* Type: `clay`


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://whitepaper.aitech.io/agentforge/tools/clay.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
