FoyerDevelopers

Generated · Live registry

channels tools

6 tools in this domain, generated from the running registry.

All tool domains

channels.activate_ota

writesconfirm

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

FieldTypeRequiredNotes
otaenumyesOTA identifier: 'booking_com' or 'expedia' — One of: booking_com, expedia

Output fields

FieldTypeRequiredNotes
okliteralyesOne of: true

channels.connect_ota

writesconfirm

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

FieldTypeRequiredNotes
otaenumyesOTA identifier: 'booking_com' or 'expedia' — One of: booking_com, expedia
hotelExternalIdstringyesHotel ID in the OTA system

Output fields

FieldTypeRequiredNotes
okliteralyesOne of: true

channels.disconnect_ota

writesconfirm

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

FieldTypeRequiredNotes
otaenumyesOTA identifier: 'booking_com' or 'expedia' — One of: booking_com, expedia

Output fields

FieldTypeRequiredNotes
okliteralyesOne of: true

channels.list

read-only

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

FieldTypeRequiredNotes
channelsarray of objectyes
channels.keyenumyesOne of: email, whatsapp, voice
channels.stateenumyesOne of: live, syncing, error, never, paused
channels.lastEventAtstring · nullableyes
channels.lastErrorstring · nullableyes

channels.list_ota_connections

read-only

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

FieldTypeRequiredNotes
connectionsarray of objectyes
connections.idstringyes
connections.otaenumyesOne of: booking_com, expedia
connections.hotelExternalIdstringyes
connections.statusenumyesOne of: pending, active, error, disabled
connections.lastSyncedAtstring · nullableyes
connections.lastErrorstring · nullableyes
connections.createdAtstringyes
connections.updatedAtstringyes

channels.set_active

writesconfirm

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

FieldTypeRequiredNotes
keyenumyesOne of: email, whatsapp, voice
activebooleanyes

Output fields

FieldTypeRequiredNotes
okliteralyesOne of: true