API & webhooks

Coco CRM exposes a full developer API. Every object in your workspace — standard and custom — is automatically available for programmatic create, read, update, and delete.

API surface

InterfaceURLNotes
GraphQL data APIhttps://crm.cocolevio.com/graphqlFull CRUD on every object, including custom ones
REST APIhttps://crm.cocolevio.com/restREST flavor of the same data API

Custom objects added by apps (deals, leads, campaigns, and so on) get typed GraphQL operations automatically — no extra setup.

Generating an API key

  1. Go to Settings → API & Webhooks.
  2. Create a new API key and give it a descriptive name.
  3. Copy the key immediately — treat it like a password.

The key inherits the permissions of the member who created it. Requests authenticate with a Bearer token.

Example request

curl -X POST https://crm.cocolevio.com/graphql \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ companies(first: 10) { edges { node { id name } } } }"}'

Replace YOUR_API_KEY with a key generated in Settings → API & Webhooks.

GraphQL playground

The GraphQL endpoint includes an interactive playground where you can browse the full schema — every object, field, and relation in your workspace — and test queries before writing code. Open the endpoint in a browser while authenticated to explore it.

Webhooks

Webhooks push events to your systems the moment data changes, instead of you polling the API.

  1. Go to Settings → API & Webhooks.
  2. Add a webhook with a target URL (your HTTPS endpoint).
  3. Choose object filters — which objects and which events to receive.

Webhooks fire on record create, update, and delete. The payload identifies the object, the event type, and the record data, so your endpoint can react accordingly.