Skip to main content

Set service provider conferencing

PUT 
/v1/services/:service_id/providers/:provider_id/conferencing

Set the conferencing configuration for a service provider. The hosting external user can be identified by ID or by email address (matched case-insensitively against the connected account's external users) — exactly one of external_user_id or email must be provided. email is a convenience; when it matches no external user, the connected account's external users are refreshed from the provider and matching is retried once, so a freshly-added user can be selected without a manual sync. Matching still fails with a 422 when the email matches zero (after a successful refresh) or multiple external users, so integrations that need determinism should resolve and use external_user_id. When the refresh itself cannot reach the provider (e.g. the connection needs to be re-authorized), a 502 is returned rather than a 422.

The external user must belong to the connected account, which must be a conferencing connection on the same account as the service provider.

Setting conferencing replaces any existing configuration for the service provider, so this operation is an idempotent upsert.

Returns a 404 when the service or provider does not exist, the provider is not assigned to the service, or the service provider is not accessible to the current actor.

Request​

Responses​

Success