Clay Block
Populate a Clay workbook with data via a webhook.
The Clay block sends data to a Clay workbook through a webhook, letting you populate Clay tables with either structured JSON or free-form plain text. Reach for it when a workflow needs to push enriched or collected data into Clay for further enrichment or outreach.
Overview
| Property | Value |
|---|---|
| Type | clay |
| Category | tools |
| Color | #E0E0E0 |
When to Use
- Push leads or contact records collected earlier in a workflow into a Clay table.
- Populate multiple Clay columns at once by sending structured JSON.
- Add free-form rows to a Clay table using plain text.
- Forward enriched data from another integration into Clay for further processing.
- Trigger Clay's enrichment pipelines by populating a workbook on demand.
Configuration
Webhook URL
The Clay webhook URL that the data is posted to. Accepts a plain URL or a {{blockName.field}} reference. Required.
Data (JSON or Plain Text)
The payload to populate your Clay table. Use JSON when populating multiple columns, or plain text for free-form rows. Can reference an upstream block's output with {{blockName.field}}. Required.
JSON vs. Plain Text:
- JSON: Best for populating multiple columns.
- Plain Text: Best for populating a table in free-form style.
Auth Token
Your Clay auth token used to authenticate the webhook request (Authorization: Bearer <token>). Stored as a password field and cannot accept a connection from another block. Use {{CLAY_AUTH_TOKEN}} to reference an environment secret. Required.
Inputs & Outputs
- Inputs:
authToken(string) — Clay authentication tokenwebhookURL(string) — Clay webhook URLdata(json) — Data to populate
- Outputs:
data(json) — Response data returned from the Clay webhook
Tools
Clay Populate (clay_populate) — Posts data to a Clay webhook endpoint via HTTP POST with a Bearer auth header. Accepts the webhook URL, a JSON or text payload, and an auth token; returns the raw response from Clay (JSON when the Content-Type is application/json, otherwise wrapped as { message: "<text>" }).
YAML Example
clay_1:
type: clay
name: "Clay"
inputs:
webhookURL: "https://api.clay.com/v3/sources/webhook/your-id"
data: "{{previous_block.enriched_data}}"
authToken: "{{CLAY_AUTH_TOKEN}}"
connections:
outgoing:
- target: next-block-id