Skip to content
Get started free
← All articles
Setup

REST API and API keys (integrations)

Integrate the CRM with other systems via a REST API, authenticated by key.

Sellio exposes a REST API for you to read and write records from other systems (Zapier, Make, your own scripts, etc.). Access is authenticated by an API key that you generate in Settings → API and keys.

Generate a key

  1. Go to Settings → API and keys.
  2. Give it a name (e.g. "Zapier integration") and click "Generate key".
  3. Copy the key RIGHT AWAY: it appears only once and cannot be recovered afterward.
  4. To turn off an integration, use "Revoke", and the key stops working immediately.
💡 The key gives full access to your organization's data. Treat it like a password: never expose it in public code or in the browser.

Endpoints

  • GET /api/v1/{object}: lists records (parameters: limit, offset, search).
  • GET /api/v1/{object}/{id}: a single record.
  • POST /api/v1/{object}: creates a record (JSON body with the fields).
  • PATCH /api/v1/{object}/{id}: updates fields of a record.

Send the key in the header Authorization: Bearer sk_live_… The {object} is the object's API Name (contact, company, lead, opportunity or one of your own objects).

Example: curl -H "Authorization: Bearer sk_live_..." https://www.selliocrm.com/api/v1/opportunity
💡 The API respects the CRM validations and business rules (required fields, validation rules, etc.), just the same as using it through the screen.

Rate limit and usage (SLA)

Each key has a limit of requests per minute (default 120), adjustable in the keys list itself. Every response carries the headers X-RateLimit-Limit (the cap), X-RateLimit-Remaining (how many still fit in the current window) and X-RateLimit-Reset (the moment, in epoch, when the window resets).

When you exceed the limit, the API responds 429 (Too Many Requests) with the Retry-After header indicating how many seconds to wait before trying again. The keys screen also shows the total requests already made by each key (usage metric).

💡 Set the limit according to your volume: 0 disables the limit for that key. Use a smaller limit for third-party integrations and a larger one for trusted internal loads.

Open this article inside the system →

Read it and want to see it working?

The account is free and the whole manual is available inside the system, with an assistant that answers from this very content.

Create free account
REST API and API keys (integrations) · Sellio