Skip to content

Integrations

The booking systems, channels and services you connected to Bookline, without their settings.

The integrations endpoints return the booking systems, channels and services you connected to your Bookline account. They return what each integration is, never its settings or credentials. They need the integrations:read scope.

Endpoint Route Scope
List integrations GET /v1/integrations integrations:read
One integration GET /v1/integrations/{integration_id} integrations:read

Integrations belong to the whole customer: a key limited to some venues gets 403 insufficient_scope. In the examples, $BASE is https://api.bookline.ai/v1 and $BOOKLINE_API_KEY is your key, as in the quick start.

GET /v1/integrations returns your integrations, paged.

Parameter Type Default Rules
limit 1 to 100 50 Integrations per page
cursor string none meta.next_cursor of the previous page, with the same limit
customer_id UUID the key’s customer See what each key reads
Ventana de terminal
curl -s -H "apikey: $BOOKLINE_API_KEY" "$BASE/integrations"
{
"data": [
{
"id": "…",
"name": "CoverManager",
"type": "COVERMANAGER",
"category": "BACKEND",
"created_at": "2026-02-11T09:30:00Z"
}
],
"meta": { "limit": 50, "next_cursor": null }
}
Field What it is
id, name The integration’s identifier and name
type The system integrated, e.g. COVERMANAGER, THE_FORK, OPENTABLE, MEWS_PMS, WHATSAPP_META; others may appear
category BACKEND: a booking or property system; CHANNEL: a conversation channel; SERVICE: any other service; NOT_AVAILABLE: not classified
created_at When the integration was installed, or last became a different one (see below); null if unknown

GET /v1/integrations/{integration_id} returns the same fields. An integration that is not your customer’s, or that was deleted, is 404 not_found.

  • created_at says since when the integration is what it is now. Changing its type or its id in the other system (e.g. a CoverManager slug), or restoring it after deleting it, restarts it.
  • Without settings. API keys, passwords and the rest of the configuration never leave Bookline.
  • Deleted integrations are neither listed nor readable by id.
  • Read only. Integrations are set up in the portal.