Skip to main content

​
Overview

You can push contacts & accounts from Clay directly into Reevo using Clay’s HTTP API integration and your Reevo API key. This allows you to sync data from Clay into Reevo for sequencing, dialing, and list management—all without manual entry.

​
Basic Concepts & Terminology

  • Clay – A lead sourcing and enrichment platform used to build targeted contact lists.
  • API Key – A unique token used to authenticate and authorize data being pushed into Reevo.
  • HTTP API (Clay) – Clay’s integration method to send data to external systems via web requests.
  • Custom Fields – Fields you define in Reevo to track data like “Lead Source” or “Campaign.”

​
Where to Find It

​
Step-by-Step Instructions

​
1. Generate your API Key in Reevo

  • Go to: Settings → Integrations → API keys → New API key
    • In order to upsert contacts & accounts from Clay to Reevo, give the API key the following permissions at a minimum:
      • Accounts - Read
      • Accounts - Write
      • Contacts - Read
      • Contacts - Write
  • Click Generate new API key
  • Name the key and click Generate
  • Copy the key and store it securely. You won’t be able to view it again after closing the popup.
Refer to this article for additional information on how to generate API Keys

​
2. Configure Clay HTTP API

  • In your Clay table, add a new Enrichment column → select HTTP API
  • Add a new HTTP API (Headers) account and give it any name
    • Under Key, enter: x-api-key
    • Under Value, paste your Reevo API key

​
3. Set your request details

​
4. Define the body of your request

Use the JSON format below to map your Clay fields to Reevo. The only required field is email, but you can include any of the supported values below. Supported values: 
email: str*
first_name: str | None = None
last_name: str | None = None
middle_name: str | None = None
phone_number: str | None = None
company: str | None = None
title: str | None = None
department: str | None = None
contact_linkedin_url: str | None = None
contact_facebook_url: str | None = None
contact_zoominfo_url: str | None = None
contact_x_url: str | None = None
contact_owner_email: str | None = None
account_linkedin_url: str | None = None
account_facebook_url: str | None = None
account_zoominfo_url: str | None = None
account_x_url: str | None = None
account_owner_email: str | None = None
account_website: str | None = None
account_custom_fields: dict[UUID | str, str | list[str]] | None = None
contact_custom_fields: dict[UUID | str, str | list[str]] | None = None
Example full request: 
curl -X POST "https://api.reevo.ai/api/v1/public/account_contact" \
	-H "Content-Type: application/json" \
	-H "X-Api-Key: Your API KEY" \
	-d '{
	"email": "[email protected]",
	"contact_owner_email": "[email protected]",
	"account_website": "https://www.acme.com",
	"account_linkedin_url": "https://linkedin.com/company/acme-corp",
	"account_facebook_url": "https://facebook.com/acmecorp",
	"account_zoominfo_url": "https://zoominfo.com/c/acme-corporation",
	"account_x_url": "https://twitter.com/acmecorp",
	"contact_custom_fields": {"Your_Custom_Field_API_Name_1": "Your Value"},
	"account_custom_fields": {"Your_Custom_Field_API_Name_2": "Your Value"}
}'

​
Sending Custom Fields

  • First create the field in Reevo. Refer to this article to learn how to create custom fields.
  • To find your custom field’s API name, go to settingsw where the custom field was created and hover over the field: Integration W Other Tools Custom Fields Pn
  • In the JSON body, use: 
    "contact_custom_fields": {
	"Your_Custom_Field_API_Name_1": "Your Value",
	"Your_Custom_Field_API_Name_2": "Your Value"}
"account_custom_fields": {
	"Your_Custom_Field_API_Name_1": "Your Value",
	"Your_Custom_Field_API_Name_2": "Your Value"}
Example JSON Body in Clay: 
json

{
"first_name": "John",
"last_name": "Doe",
"email": "[email protected]",
"contact_custom_fields": {
	"cus_field__Lead_Source": "inbound_form",
	"cus_field__Lead_Source_Details": "board member"
}
}
5. Run your enrichment
  • Click Run on your Clay table
  • If successful, you’ll see a Status Code: 200 response

​
Troubleshooting/FAQs

Go to Settings → Integrations → API Keys in Reevo and generate a new key.
Yes. You must first create the field in Reevo and copy the Field API name. Use it in the contact_custom_fields or account_custom_fieldsobject of the JSON body.
To find your custom field’s API name, hover over the field on the custom field Settings page in Reevo.
Yes. Just modify the JSON body to pull in any value from your Clay table.
Many users include a “Lead Source” or “List Name” so contacts can be filtered and grouped in Reevo for sequencing or dialing later.