Offene API

API

Dein Stack redet mit Coldfire.

REST-API mit API-Keys pro Agentur und granularen Scopes. Leads importieren, per externer ID wiederfinden, gezielt patchen – und signierte Webhooks, wenn im CRM etwas passiert. Kein CSV-Export, kein Polling.

EndpunkteBearer cf_… oder X-API-Key
Scopes pro Key
leads.importleads.readleads.update
POSThttps://api.coldx.io/api/v1/leads/import
JSON · agency-scoped
Request
curl -X POST https://api.coldx.io/api/v1/leads/import \
  -H "Authorization: Bearer cf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "leads": [{
      "company_name": "Acme GmbH",
      "website": "acme.de",
      "zip": "10115", "city": "Berlin",
      "contacts": [{
        "firstname": "Sara", "lastname": "Meier",
        "email": "sara@acme.de", "phone": "+49301234567"
      }],
      "custom_fields": { "42": "ext-123" }
    }]
  }'
Response
{
  "job_id": 123,
  "status": "pending",
  "total": 1,
  "duplicates_detected": 0
}

Bulk-Import mit Kontakten, Adressen und Custom Fields. Dubletten werden erkannt und gemergt statt doppelt angelegt. Optional bekommt jeder importierte Lead sofort eine Nachfass-Aufgabe für einen festen Agenten.

Rate-Limits: Import 10 Requests/Min · Read/Update 120 Requests/Min · bis zu 5.000 Leads pro Import-Request

API-Keys mit Scopes

Keys pro Agentur, gehasht gespeichert, jederzeit rotierbar. Scopes für Import, Lesen und Schreiben – jeder Key sieht nur die Daten seiner Agentur.

Import mit Dedup

Bis zu 5.000 Leads pro Request inkl. Kontakte, Adressen und Custom Fields. Dubletten werden erkannt und zusammengeführt.

Idempotenter Sync

Finde Leads über deine externe ID, lies alles in einem Call und patche exakt die Felder, die sich geändert haben. Gebaut für Sync-Jobs und deine eigenen Daten-Pipelines.

Signierte Webhooks

Termine und Custom Activities pushen Payloads an deinen Server – HMAC-SHA256-signiert im Header X-Coldfire-Signature. Dein Server kann sogar Mail-Inhalte zurückgeben.

Bereit, die schwere Arbeit den Workflows zu überlassen?

Richte deine erste Calling-Kampagne in Minuten ein. Coldfire übernimmt den Rest – von Nachfassaktionen bis hin zu Status-Updates.

COLDFIRE