The SDK is a thin client over this API. Use the API directly from any language, or to see exactly what goes over the wire.

Base URL

Use the address your CRM is served on. Every endpoint is versioned under /v1, and every one is a POST with a JSON body. Ids go in that body, never in the URL. contacts/upsert and contacts/get take your own dbId; every other endpoint takes the CRM’s partyId, which upsert, get and contacts/resolve return.

Authentication

Send an API key from Settings → API keys as a bearer token. Keys start with gd_key_.
A call made with a key acts as the person who created it, in that key’s workspace. A revoked key gets 401 straight away.
Keys can write to your workspace. Use them only from your backend.

Responses

A successful call answers 200 with the result under data:
A failed one answers with an error status and a type and message:

OpenAPI

The full spec is served at /public-api/openapi, and the reference in this tab is generated from it.