Sync external users
Refresh the external users for a connected account by syncing them from the provider (e.g., pulling the current list of users from a connected Zoom account). New users are added, existing users are updated, and users no longer present at the provider are removed. Returns the full, refreshed list of external users.
Returns a 404 when the connected account does not exist, is not accessible to the current actor, or is not a conferencing connected account. Returns a 502 when the provider could not be reached or rejected the request (e.g. the connection needs to be re-authorized).
Authorization
authorization In: header
Path Parameters
The connected account's unique identifier
^cact_\w{12}$Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/connected_accounts/cact_abcdef123456/external_users/sync"{ "data": [ { "email": "dr.smith@example.com", "first_name": "Jane", "id": "exusr_d025a96ac0c6", "last_name": "Smith", "object": "external_user", "status": "active" } ]}Set user mapping PUT
Set the default user mapping between a provider and an external user on a connected account. The external user can be identified by ID or by email address (matched case-insensitively against the connected account's external users) — exactly one of the two 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 mapped 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. Setting a mapping replaces any existing mapping for the provider on this connected account, so this operation is an idempotent upsert. Returns a 404 when the connected account does not exist, is not accessible to the current actor, or is not a conferencing connected account; or when the provider does not exist or has been deactivated.
Update connected account PATCH
Update an existing connected account.