Clay API und Integrationen: rein, raus, von Hand verdrahtet

Das Wichtigste in Kürze Clay hat eine öffentliche API. Sie liegt unter https://api.clay.com/public/v0, authentifiziert über den Header clay-api-key und listet 13 dokumentierte Operationen. Die zugehörige OpenAPI-3.1.0-Spezifikation stand am 29. August 2026 unter developers.clay.com/openapi.json, 67.151 Bytes groß. Fünf weitere Dinge heißen im Alltag „die Clay-API“ und sind es nicht: die HTTP-Spalte, die eingehende Webhook-Quelle, der ausgehende signierte Webhook, die native Anbieteraktion, der MCP-Server. Andere Tarife, andere Obergrenzen. Wo Clay ein Verhalten beschreibt, aber keine Zahl dazu veröffentlicht, steht das hier so.

Letzten Monat hat mir ein RevOps-Verantwortlicher einen Blogbeitrag geschickt, als Beleg dafür, dass Clay keine API habe. Viele Texte behaupten das immer noch. Sie beschreiben ein Produkt, das inzwischen weiter ist. Die Basis-URL ist öffentlich, und die Spezifikation lädt sauber herunter. Ich habe sie am 29. August gezogen: 67.151 Bytes, OpenAPI 3.1.0, 13 Operationen.

Die Entwicklerplattform hat nie einen eigenen Changelog-Eintrag bekommen. Auch deshalb hält sich die veraltete Antwort so hartnäckig in den Suchergebnissen. Was jetzt kommt, ist die Verdrahtung: was Zeilen anlegt, was Zellen füllt, woran dein Code herankommt, und jede Obergrenze, die Clay veröffentlicht hat.

Hat Clay eine API?

Ja. Clays öffentliche API liegt unter https://api.clay.com/public/v0. Authentifiziert wird über den Header clay-api-key, den du unter Settings → Account → API keys ausstellst, noch als Beta gekennzeichnet. Dahinter stehen 13 Operationen: eine Identitätsprüfung, Routine-Läufe, Batch-Läufe, Searches und Tabellenabfragen. Auf einen abgelehnten Schlüssel antwortet Clay mit {"message": "Authentication failed"}. Der Schlüssel gehört auf den Server, nicht in den Browser.

Die Spezifikation ist maschinenlesbar, dein Client kann sich also selbst erzeugen. In openapi.json stehen info.title „Clay Public API“, info.version „0“ und ein einziges Schema namens ClayApiKey. Eine openapi.yaml gibt es nicht.

Clay-Integrationen: zehn Oberflächen, und wie du die richtige findest

Zeilen kommen über eine Quelle herein oder gar nicht – die öffentliche API liest Tabellen, baut aber keine.

Die meisten Tickets, in denen „wir brauchen die Clay-API“ steht, meinen eine Quelle oder eine Spalte. Dazwischen liegt der Unterschied zwischen einem Sprint und einem Tarifwechsel.

Bevor du um den letzten Block herum planst, nimm einen Widerspruch mit. university.clay.com/docs/clay-api-cli schreibt, die Entwicklerplattform sei „available across all Clay plans, including free and trial plans“, und API- wie CLI-Aufrufe verbrauchten „the same credits and actions as the equivalent work done in-product“. Die Preis-FAQ dagegen führt „Clay API access“ als Enterprise-Punkt, und in der Vergleichstabelle taucht überhaupt keine API-Zeile auf. Prüf das zuerst in deinem eigenen Workspace. Zwei Randnotizen aus derselben Doku: CLI und API sind in der offenen Beta auf Mac und Linux unterstützt, nicht auf Windows, und das Agent-Plugin läuft in der Beta auf den aktuellen Tarifen, auf den alten noch bis Ende 2026.

Launch kostet 185 $ im Monat, jährlich gezahlt 167 $, Growth 495 $ oder eben 446 $ – Clay veröffentlicht diese Preise in Dollar, deshalb stehen sie auch hier in Dollar. Die vollständigen Leitern liegen in Clay-Preise. Sein Anbieterverzeichnis zählt Clay auf drei Arten: „200+ providers“ in der Navigation, „150+ data partners“ in der Preis-FAQ, und 157 eindeutige /integrations/data-provider/-URLs, als ich am 29. August auf clay.com/integrations nachgezählt habe, verteilt auf 24 Kategorien.

Routines: die Arbeitseinheit, die dein Code aufrufen kann

Eine Routine ist Clay-Logik mit einer Adresse. Du legst in der Oberfläche eine eigene Funktion an, schaltest ihre API-Integration frei, nimmst die t_...-ID und stellst function: davor.

Kleine Aufgaben laufen direkt durch. POST /routines/{routine_id}/run nimmt ein items-Array mit mindestens einem und höchstens 100 Einträgen entgegen. Clay hat die Referenzseite dazu „Execute a routine against 1-100 items“ genannt, die Obergrenze steht also schon in der Überschrift. Zurück kommt ein 202 mit einer routine_run_id, dazu optional ein webhook_id.

Größere Aufgaben sind vier Aufrufe. Erst holst du dir eine vorsignierte URL von run-batch/upload-url, dann schiebst du die JSONL per PUT als application/x-ndjson hoch, Zeilen in der Form {"id": "row-1", "inputs": {"domain": "clay.com"}}, danach POST auf run-batch/start und zum Schluss GET /routines/run-batch/{id}/results. Die CLI fasst alle vier zu clay routines runs start function:t_abc123 --bulk rows.jsonl zusammen, und clay login --device meldet dich auf einem Rechner ohne Browser an.

Searches fragt Clays eigene GTM-Datenbank ab, entweder über die erweiterte Suche (Beta, verschachtelte Boolesche Ausdrücke) oder über strukturierte Filter, innerhalb der Grenzen aus der Tabelle weiter unten. Reißt du eine davon, kommt HTTP 402 zurück und nennt sie beim Namen. Ein Vorbehalt dazu: university.clay.com/docs/clay-api-cli druckt 10.000 Ergebnisse je Anfrage für die zahlenden Self-Serve-Tarife, developers.clay.com/searches druckt 500. Ich zitiere die Entwicklerdoku.

Fehlt noch die Grenze, die auf Seite eins der Suchergebnisse niemand nennt. Clay schreibt, es gebe „no current plans to support table building via the developer platform“. Tables liest nur, ausschließlich auf Enterprise, über POST /public/v0/tables/query, und einen Endpoint zum Auflisten der Tabellen gibt es nicht. Zeilen kommen über eine Quelle herein oder gar nicht. In welcher Reihenfolge du diese Seite aufbaust, steht in So nutzt du Clay.

Was Clay dir sagt, wenn ein Aufruf scheitert

Clay dokumentiert sein Verhalten im Fehlerfall gründlich und veröffentlicht keine einzige Zahl dazu, wo die Drossel greift. Kläre das, bevor du einen Job dimensionierst.

Das Rate-Limit für Anfragen gilt je Workspace. Reißt du es, kommt HTTP 429, dazu Retry-After in Sekunden und die Header X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset, „when available“. Die CLI wirft Exit-Code 4. Clay rät, 429 als wiederholbar zu behandeln und Batch- und Async-Endpoints engen Polling-Schleifen vorzuziehen („prefer batch and async endpoints over tight polling loops“).

Alles außerhalb von 2xx kommt als JSON mit einer lesbaren message zurück. Clay hält fest: „Error response bodies do not currently include stable error codes.“ Dein Switch läuft also über den Status – 401 und 403 Authentifizierung, 404 nicht vorhanden, 409 und 422 Validierung, 429 Rate-Limit, 5xx vorübergehend. Ein 202 auf einem asynchronen Endpoint ist übrigens kein Erfolg. Es heißt, dass der Lauf noch läuft.

Die HTTP-API-Spalte: eine Quelle anbinden, von der Clay nie gehört hat

Mit dieser Spalte richtest du Clay auf etwas aus, das nicht im Verzeichnis steht. Sie schickt Daten an ein beliebiges Werkzeug oder eine beliebige Datenbank und holt sie wieder ab, „even when Clay doesn't offer a native integration“, über GET, POST, PUT und DELETE. Jeder Statuscode, den Clay dafür dokumentiert, beschreibt den Endpoint, den du aufgerufen hast, nicht Clay selbst. Wird eine Spalte rot, schaust du deshalb zuerst dorthin.

Die letzte Zeile dreht die übliche Ordnung um. Die Drossel stellst du selbst ein, Clay legt sie dir nicht auf. Dafür gibt es zwei Felder, Request limit und Duration (ms), und Clays eigenes Beispiel von 10 auf 1.000 ms sind zehn Anfragen in der Sekunde.

Zwei Warnungen zu Zugangsdaten, beide von Clay. Tippst du einen Schlüssel direkt ins Feld Headers, liegt er im Klartext offen für jeden, der die Spalte sehen darf („visible in plain text to anyone with access to the table column“). Nimm also ein gespeichertes Konto. Der Haken ist nur: Änderst du das später, betrifft es „every HTTP API enrichment column across your workspace that uses it“.

Clay-Webhooks zeigen in zwei Richtungen und teilen sonst nichts

Die Tabelle zu leeren gibt keine der 50.000 Übermittlungen zurück, und ein ausgehender Webhook kommt womöglich nie an.

Eingehend ist eine Quelle. Unten im Workbook auf + Add, nach Webhooks suchen, Monitor webhook wählen, URL kopieren. Den Auth-Token siehst du genau einmal: „Make sure to copy the token immediately, as you can only access authentication tokens once.“ Dann kommt die Grenze, an der es Teams erwischt. Eine Webhook-Quelle nimmt 50.000 Übermittlungen an, und dieser Zähler bleibt stehen, auch wenn du Zeilen löschst („persists even after deleting rows“). Die Tabelle zu leeren bringt nichts, unterhalb von Enterprise stellst du eine neue Quelle daneben. Der Leitfaden trägt außerdem das Etikett eines Tarifs namens „Explorer“, den die Preisseite gar nicht mehr führt – prüf die Stufe also in deinem eigenen Workspace nach.

Ausgehend gehört zur Entwicklerplattform. clay webhooks create https://example.com/hooks/clay liefert id, url, createdAt und ein signingSecret, das du sofort wegspeichern musst – „store immediately, it can't be retrieved later“. Die Nutzlast trägt webhookId, createdAt und ein data-Objekt, signiert als X-Clay-Signature: sha256= plus HMAC-SHA256 über den Body. Und dann steht dort ein Satz, der deine Architektur formen sollte und nicht bloß deine Fehlerbehandlung: „Webhook delivery is not guaranteed. Use webhooks to react faster, but keep polling the run's results as a fallback.“

Clay und LinkedIn: die Grenzen von Find People, und was die Chrome-Extension wirklich tut

Listen im LinkedIn-Zuschnitt fangen meistens bei Find People an, unter den Grenzen aus der Tabelle weiter unten. Dazu kommen Ausschlusslisten, 300.000 Personen insgesamt und 100.000 je Quelle, verteilt auf drei Sätze und abgeglichen über LinkedIn-URLs. Woher die Daten dahinter stammen, sagt Clays Dokumentation nirgends. Also sage ich es auch nicht.

Bei der Chrome-Extension liegen die meisten Suchenden daneben, deshalb ganz nüchtern: Clays Dokumentation beschreibt beide Erweiterungen als Werkzeuge zum Auslesen, nicht zum Aufdecken von Kontaktdaten. Clay for Chrome zieht strukturierte Daten von einer Seite und legt Felder wie Name, Website, LinkedIn oder Crunchbase in einer Tabelle ab. Clip to Clay speichert ganze Seiten. Der Store-Eintrag steht bei 4,4 von 5 aus neun Bewertungen, 10.000 Nutzern, Version 1.0.0, zuletzt aktualisiert am 10. April 2025.

Clay-MCP: dein Workspace im Assistenten

Clays MCP-Server hängt einen Workspace an Claude, ChatGPT, Microsoft Copilot und Glean; verwaltet wird das unter Settings → MCP users. Die Credit-Steuerung gibt es auf Launch, Growth und Enterprise, die Steuerung der Zielgruppe ausschließlich auf Enterprise. Abgerechnet wird exakt wie im Produkt: „If a Function that finds someone's email and phone number costs 12 credits in a Clay table, it costs 12 credits when a rep triggers it from Claude or ChatGPT.“ Das Agent-Plugin ist noch einmal etwas anderes. Clays Entwicklerdoku beschreibt es als Auslieferung von Clays Skills samt clay-CLI an Coding-Agenten wie Claude Code, Codex und Cursor, es läuft also im Terminal und nicht in einem Chat-Client.

Jede Grenze, die Clay schriftlich festhält

Fast jede Grenze bei Clay lautet 50.000, und die Webhook-Quelle ist die eine, um die herum du planen musst, weil ihr Zähler das Löschen überlebt.

Massenanreicherung über 50.000 Datensätze hinaus gibt es nur auf Enterprise. Vor einem großen Import lohnt außerdem ein Satz aus Clays Doku zu den Quellen. Zur Zeilengrenze steht dort: „Clay imports records up to the limit and stops automatically. No error message is displayed.“ Clay schlägt selbst vor, die Datei nach Filter oder Zeitraum zu teilen oder auf Enterprise zu wechseln, wo Tabellen mit automatischer Löschung und Massenanreicherung bereitstehen.

Enrow als Spalte in deiner Tabelle

Weder Clay noch Enrow berechnet eine leere Suche – eine Kette mit Wiederholungen zahlt nur, wenn ein Ergebnis zurückkommt.

Enrow steht seit dem 1. September 2024 in Clays Verzeichnis, unter Contact Data und Contact Data Verification, als von Clay entwickelte Integration mit dem Etikett „Included in All Plans“. Drei Aktionen laufen als Spalten, und jede liefert neben dem Ergebnis einen Qualifizierungsstatus mit.

Für dieselbe Verifizierung hält Enrows eigene Doku Kosten in Clay-Credits fest, während Clays Eintrag sie kostenlos nennt. Klär das in der App, bevor du damit rechnest. Mit deinem eigenen Schlüssel richtest du eine HTTP-API-Spalte auf https://api.enrow.io/email/find/single, Header x-api-key und Content-Type: application/json, Body {"company_domain": /company_domain, "fullname": "/first_name /last_name"}. Die Antwort kommt asynchron, du übergibst also eine Clay-Webhook-URL in settings.webhook oder fragst die Such-ID am passenden GET-Endpoint ab, bis sie zurückkommt. Request limit auf 10, Duration auf 1000, dann passt es zusammen: Jeder POST-Endpoint von Enrow erlaubt zehn Anfragen in der Sekunde je Schlüssel, und ein Bulk-POST zählt als eine einzige Anfrage, selbst wenn 5.000 E-Mail-Einträge darin stecken.

Jetzt der Teil, der in einer Kette mit Wiederholungen zählt. Clays Regel lautet: „If an enrichment returns no result, you're not charged Data Credits or Actions.“ Auf der Lieferantenseite passt Enrows Regel dazu. Ein Credit verlässt den Topf, wenn ein gültiges Ergebnis zurückkommt, nie bei einem Fehlschlag, nie bei einem Bounce. Landet etwas, kostet eine E-Mail einen Enrow-Credit, eine Direktnummer 40, eine Verifizierung ein Viertel, alles aus einem gemeinsamen Topf. Die Reihenfolge behandeln die Anreicherungs-Wasserfälle in Clay.

Hinter jeder Adresse stehen über zehn Prüfungen, Catch-all-Domains werden aufgelöst und zugestellt statt als riskant abgestempelt, europäische Handynummern kommen mit ihrer DSGVO-Dokumentation. Die Trefferquote liegt auf unseren eigenen Dateien bei rund 60 %, die Bounce-Rate unter 1 %. Das sind Messwerte von uns, keine Zusage.

Die Liste, die Enrow dir nicht anlegt

Enrow löst Personen auf, die du schon identifiziert hast. Für eine E-Mail-Adresse braucht es einen vollständigen Namen und eine Domain, für eine Handynummer eine Profil-URL oder einen Namen samt Firmenkontext. Zum Stöbern liegt nichts dahinter, „alle VP Engineering in Amsterdam bei Series-B-Firmen“ kommt deshalb leer zurück. Das ist Absicht. Gespeicherte Zeilen veralten still vor sich hin, eine Auflösung in Echtzeit nicht, und mir ist eine fehlende Suchfunktion lieber als eine mit alten Daten. Innerhalb von Clay kostet dich das ohnehin nichts, weil Find People, ein CRM-Sync oder eine CSV diese Aufgabe schon vorher erledigen. Die Kriterien dafür stehen in So wählst du einen B2B-Datenanbieter.

Läuft dein Prozess in Code statt in einem Workbook, antworten dieselben Abfragen direkt. Die Enrow-API stellt einen Schlüssel aus, ohne dass du mit einem Vertriebler sprichst, und offizielle SDKs gibt es inzwischen für sieben Sprachen – JS/TypeScript, Python, PHP, Go, Java, Swift und Rust, alle im Early Access und aus dem GitHub-Quellcode. Der MCP-Server EnrowAPI/enrow-mcp hängt dieselben drei Abfragen hinter einen Assistenten, sodass Claude oder Cursor einen Kontakt auflösen, ohne dass eine Tabelle dazwischensteht. Die Endpoints im Detail stehen in E-Mail-Finder-API.

FAQ

Ist die Clay-API kostenlos?

Die Entwicklerplattform kostet keinen Aufschlag. Clays Doku schreibt, sie sei auf allen Tarifen verfügbar, Gratis- und Testtarif mitgezählt, und API- wie CLI-Aufrufe verbrauchten dieselben Credits und Actions wie dieselbe Arbeit im Produkt. Die Schranke sind die 500 Actions und 100 Data Credits im Monat auf dem Gratis-Tarif.

Was ist der Unterschied zwischen Clays HTTP-API und Clays öffentlicher API?

Clays HTTP-API und Clays öffentliche API zeigen in entgegengesetzte Richtungen. Die HTTP-API ist eine Spalte in einer Clay-Tabelle, die einen fremden Endpoint aufruft und die Antwort in eine Zeile schreibt, in Clays Vergleichstabelle auf Growth gesetzt. Die öffentliche API unter https://api.clay.com/public/v0 ist die Oberfläche, die dein eigener Code von außerhalb Clays aufruft, um Routinen laufen zu lassen, Batch-Jobs zu starten und Searches abzufragen.

Welchen Tarif brauche ich für Clays HTTP-API und Webhooks?

Growth. Clays Vergleichstabelle führt „HTTP API integrations“ und „Automate any signal via webhooks“ als nicht enthalten auf Free und Launch, CRM- und Warehouse-Verbindungen liegen auf derselben Stufe. Die öffentliche API, die CLI und der MCP-Server laufen laut Clays Entwicklerdoku auf jedem Tarif.

Wie hoch sind die Rate-Limits der Clay-API?

Clay veröffentlicht das Verhalten, nicht die Zahl. Die öffentliche API erzwingt ein Rate-Limit für Anfragen je Workspace, antwortet mit HTTP 429, schickt Retry-After in Sekunden und ergänzt X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset, sofern verfügbar. Eine Angabe zu Anfragen pro Sekunde steht in der Doku nirgends.

Kann ich mit der API Daten in eine Clay-Tabelle schreiben?

Nein. Clay schreibt, es gebe derzeit keine Pläne, den Aufbau von Tabellen über die Entwicklerplattform zu unterstützen. Tables ist lesend und nur auf Enterprise verfügbar, abgefragt über POST /public/v0/tables/query mit höchstens 100 Zeilen je Seite. Zeilen kommen über eine Quelle herein.

Gibt es in Clay ein Webhook-Limit?

Ja, und es ist dauerhaft. Eine Clay-Webhook-Quelle nimmt 50.000 Übermittlungen an, und Clay dokumentiert, dass die Grenze auch nach dem Löschen von Zeilen bestehen bleibt („persists even after deleting rows“). Die Tabelle zu leeren setzt also nichts zurück. Unterhalb von Enterprise hilft eine neue Quelle; auf Enterprise fällt die Decke mit Tabellen, die automatisch löschen.

Was macht die Clay-Chrome-Extension?

Die Clay-Chrome-Extension liest Seiten aus, statt Kontaktdaten aufzudecken. Clay for Chrome zieht strukturierte Daten von einer Webseite, aus einer automatisch erkannten Liste oder von einem einzelnen Profil, in eine Clay-Tabelle und legt Felder wie Name, Website, LinkedIn, Twitter oder Crunchbase ab. Clip to Clay, die zweite Erweiterung, speichert ganze Webseiten in einer Tabelle.

Hat Clay einen MCP-Server?

Ja. Er verbindet einen Workspace mit Claude, ChatGPT, Microsoft Copilot und Glean, verwaltet unter Settings → MCP users, mit Credit-Steuerung ab Launch und einem Budget, das am 1. jedes Monats um Mitternacht UTC zurückgesetzt wird. Einen MCP-Aufschlag verlangt Clay nicht: 12 Credits in einer Tabelle sind 12 Credits aus einem Assistenten heraus.

Mach also deinen Workspace auf, schreib auf, was du tatsächlich laufen hast, und ordne jedem Punkt eine Zeile aus der ersten Tabelle zu. Die Antwort auf „können wir das automatisieren“ steckt meistens schon im Konto, eine Stufe höher oder eine Spalte weiter.

Fehlt dir dabei die verifizierte E-Mail-Adresse oder die europäische Handynummer, steht Enrow im Verzeichnis als Spalte, die du heute einschalten kannst. Der Gratis-Tarif legt dir zu jedem Monatsanfang 50 Credits hin, dauerhaft, und fragt dafür nach keiner Karte.