Pick a calendar or a staff member
calendar_id picks the calendar to use, one that GET /calendars//calendars lists as writable. staff_id makes the connection a staff member’s calendar, or with null the business’s. Values the connection already has change nothing. A new calendar_id is checked with Google: a connection Google no longer accepts is a 409, and a deployment without Google Calendar answers 403.
Autorizaciones
An API key from Settings > API keys (lsk_...), which acts on its own business, or a platform key from the PLATFORM_API_KEYS setting (lsp_...), which onboards and manages businesses. Scopes: business:read, business:write, calls:read, contacts:read, contacts:write, appointments:read, appointments:write, messages:read, knowledge:read, knowledge:write, webhooks:manage, billing:manage, phone_numbers:manage, team:manage, businesses:create, users:create. Only platform keys can hold businesses:create and users:create.
Encabezados
The business a platform key acts on. Required with a platform key. A per-business key may leave it out; if it sends one, it must be the key's own business.
Parámetros de ruta
The calendar connection id.
Cuerpo
A writable calendar from GET /calendars/{connection_id}/calendars. Picking another one reads it again, so the staff it covers can't be booked until that finishes.
1 - 255An active staff member from GET /staff, or null for the business's calendar.
Respuesta
OK
A calendar account connected to the business.