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.
List integrations
Section titled “List integrations”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 |
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 |
One integration
Section titled “One integration”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.
Data rules
Section titled “Data rules”created_atsays 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.
Related
Section titled “Related”- Installing an integration and booking platforms: what each integration does and how to set it up.
- Campaigns:
integration_typenames the system a campaign reads.
