Jelliu API documentation

{
  "data": [
    {
      "id": "3d9f1b2a-6c4e-4f8a-9b1d-2e7c5a0f8d13",
      "tenant_id": "8a41c7e2-3b5d-4f09-a6e1-7d2c9b0f4e58",
      "provider": "kommo",
      "label": "Kommo ventas Bogotá",
      "auth_method": "oauth2",
      "status": "active",
      "credentials": "***",
      "contact_count": 0,
      "last_synced_at": null,
      "last_error": null,
      "field_mapping": {},
      "campaign_id": null,
      "oauth_expires_at": "2026-09-16T02:14:09.000Z",
      "oauth_scopes": null,
      "inbound_webhook_uuid": "5b2e8c71-0d4a-4e93-b6f2-9a1c3d7e0b44",
      "created_at": "2026-09-02T14:21:37.000Z",
      "updated_at": "2026-09-15T02:14:09.000Z",
      "deleted_at": null
    },
    {
      "id": "c71e4a09-2f8b-4d63-8e15-b90d3a6c2f71",
      "tenant_id": "8a41c7e2-3b5d-4f09-a6e1-7d2c9b0f4e58",
      "provider": "webhook",
      "label": "Formulario web",
      "auth_method": "credentials",
      "status": "active",
      "credentials": "***",
      "contact_count": 412,
      "last_synced_at": "2026-09-14T22:03:51.000Z",
      "last_error": null,
      "field_mapping": {
        "correo": "email",
        "nombre": "name",
        "telefono": "phoneNumber"
      },
      "campaign_id": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
      "oauth_expires_at": null,
      "oauth_scopes": null,
      "inbound_webhook_uuid": "e04f7b3a-91c2-4d58-a3e6-1f8b2c9d7a05",
      "created_at": "2026-08-19T16:45:02.000Z",
      "updated_at": "2026-09-14T22:03:51.000Z",
      "deleted_at": null
    }
  ]
}

Returns the workspace’s integrations, newest first (created_at descending). Deleted integrations are never included. Use GET /api/integrations/{integrationId} for the full record (webhook secret, OAuth metadata, discovered schema); list rows carry only the display columns documented on Integration.

Pagination. Offset-based. The response carries no total and no next-page marker: request the next page with offset = offset + limit until a page comes back with fewer than limit rows.

Consistency. The first four pages (offsets that are exact multiples of limit) are cached for up to 5 minutes and cleared on every write to an integration; other offsets are read live.

Access

Required scope: read (or write). Any workspace member can call it.
Rate limit: General API — 120 to 600 requests/min per workspace depending on plan. See Rate limits.
Plan: Available on every plan.

Returns the workspace's integrations, newest first (`created_at` descending). Deleted integrations are never included. Use `GET /api/integrations/{integrationId}` for the full record (webhook secret, OAuth metadata, discovered schema); list rows carry only the display columns documented on `Integration`. **Pagination.** Offset-based. The response carries no total and no next-page marker: request the next page with `offset` = `offset` + `limit` until a page comes back with fewer than `limit` rows. **Consistency.** The first four pages (offsets that are exact multiples of `limit`) are cached for up to 5 minutes and cleared on every write to an integration; other offsets are read live. **Access** - **Required scope:** `read` (or `write`). Any workspace member can call it. - **Rate limit:** General API — 120 to 600 requests/min per workspace depending on plan. See [Rate limits](/rate-limits). - **Plan:** Available on every plan.

Authentication

AuthorizationBearer

Workspace API key: jl_ followed by 64 lowercase hex characters, created by the workspace owner in the dashboard (Settings → API Keys) and sent as Authorization: Bearer jl_.... The plaintext is shown once, at creation; Jelliu stores only a SHA-256 hash. A workspace can hold up to 25 active keys.

Scope	GET / HEAD	POST / PUT / PATCH / DELETE	Admin-only routes
`read`	Yes	No	No
`write`	Yes	Yes	No
`full`	Yes	Yes	Yes

Operations restricted to admins or owners reject keys without the full scope with 403, and say so in their description. No key, whatever its scope, can mint or revoke API keys or rotate a webhook secret — that requires a signed-in owner session. A revoked key stops authenticating within about 10 seconds. See Authentication.

Workspace API key: `jl_` followed by 64 lowercase hex characters, created by the workspace owner in the dashboard (**Settings → API Keys**) and sent as `Authorization: Bearer jl_...`. The plaintext is shown once, at creation; Jelliu stores only a SHA-256 hash. A workspace can hold up to 25 active keys. | Scope | GET / HEAD | POST / PUT / PATCH / DELETE | Admin-only routes | | --- | --- | --- | --- | | `read` | Yes | No | No | | `write` | Yes | Yes | No | | `full` | Yes | Yes | Yes | Operations restricted to admins or owners reject keys without the `full` scope with `403`, and say so in their description. No key, whatever its scope, can mint or revoke API keys or rotate a webhook secret — that requires a signed-in owner session. A revoked key stops authenticating within about 10 seconds. See [Authentication](/authentication).

Query parameters

limitintegerOptional1-100Defaults to 50

Page size. Values outside 1–100 or non-integers are rejected with 400, not clamped.

offsetintegerOptional0-100000Defaults to 0

Number of integrations to skip. Values outside 0–100000 are rejected with 400.

Response

One page of integrations, newest first. Credentials are always the literal ***.

datalist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

Pagination. Offset-based. The response carries no total and no next-page marker: request the next page with offset = offset + limit until a page comes back with fewer than limit rows.

Consistency. The first four pages (offsets that are exact multiples of limit) are cached for up to 5 minutes and cleared on every write to an integration; other offsets are read live.

Access

Required scope: read (or write). Any workspace member can call it.
Rate limit: General API — 120 to 600 requests/min per workspace depending on plan. See Rate limits.
Plan: Available on every plan.