channels.activate_ota
Set a direct Booking.com/Expedia connection from 'pending' to 'active' so rate and availability pushes begin. Call after credentials have been stored via credentials.set. Refused while a Beds24 connection is active — the two must never push to the same channels at once. Mutating action — requires _confirm: true.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
ota | enum | yes | OTA identifier: 'booking_com' or 'expedia' — One of: booking_com, expedia |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
ok | literal | yes | One of: true |
channels.connect_ota
Add or update an OTA connection for the current tenant. Creates the connection with status='pending' if it does not exist, or updates hotelExternalId and resets status to 'pending' on conflict. Mutating action — requires _confirm: true.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
ota | enum | yes | OTA identifier: 'booking_com' or 'expedia' — One of: booking_com, expedia |
hotelExternalId | string | yes | Hotel ID in the OTA system |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
ok | literal | yes | One of: true |
channels.disconnect_ota
Remove an OTA connection for the current tenant. Deletes the connection row; rate pushes to this OTA will stop immediately. Mutating action — requires _confirm: true.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
ota | enum | yes | OTA identifier: 'booking_com' or 'expedia' — One of: booking_com, expedia |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
ok | literal | yes | One of: true |
channels.list
List the ingestion channels (email, whatsapp, voice) with their current state, last-event timestamp, and last-error string. Read-only.
Input parameters
Returns object.
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
channels | array of object | yes | |
channels.key | enum | yes | One of: email, whatsapp, voice |
channels.state | enum | yes | One of: live, syncing, error, never, paused |
channels.lastEventAt | string · nullable | yes | |
channels.lastError | string · nullable | yes |
channels.list_ota_connections
List all OTA (Online Travel Agency) connections for the current tenant. Returns booking_com and expedia connections with their status, hotel external ID, last sync time, and last error. Read-only.
Input parameters
Returns object.
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
connections | array of object | yes | |
connections.id | string | yes | |
connections.ota | enum | yes | One of: booking_com, expedia |
connections.hotelExternalId | string | yes | |
connections.status | enum | yes | One of: pending, active, error, disabled |
connections.lastSyncedAt | string · nullable | yes | |
connections.lastError | string · nullable | yes | |
connections.createdAt | string | yes | |
connections.updatedAt | string | yes |
channels.set_active
Pause or resume a single ingestion channel. active=false sets state to 'paused' (a kill-switch — channel won't auto-recover on next event); active=true clears the pause flag and restores normal state. Mutating action — requires _confirm: true.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
key | enum | yes | One of: email, whatsapp, voice |
active | boolean | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
ok | literal | yes | One of: true |