API ReferenceConnected accounts

Update connected account

Update an existing connected account.

PATCH
/v1/connected_accounts/{connected_account_id}

Authorization

authorization
AuthorizationBearer <token>

In: header

Path Parameters

connected_account_id*string

The connected account's unique identifier

Match^cact_\w{12}$

Request Body

application/json

Connected account params

TypeScript Definitions

Use the request body type in TypeScript.

Request schema for updating a connected account

Response Body

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/v1/connected_accounts/cact_abcdef123456" \  -H "Content-Type: application/json" \  -d '{    "display_name": "Work Calendar"  }'
{  "data": {    "connection_scope": "user",    "created_at": "2025-03-12T12:34:55Z",    "display_name": "John Doe",    "email": "user@example.com",    "external_account_id": null,    "external_subject": "123456789",    "id": "cact_d025a96ac0c6",    "object": "connected_account",    "provider": "google",    "status": "active",    "updated_at": "2025-03-13T10:11:12Z",    "user_id": "user_d025a96ac0c6"  }}

Sync external users POST

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).

Create dashboard session POST

The Dashboard Sessions API allows you to generate a short-lived session link that grants an account member access to the dashboard without requiring login credentials. This is useful for creating seamless, secure login experiences from external systems or integrations. Before you can generate a session link for someone, you'll need to add them to your SavvyCal account. You can do this by navigating to [Settings → Members & permissions](https://savvycal.app/users) and following the instructions to add a new user. Alternatively, you may use the [Create account user API](https://developers.savvycal.app/api/create-account-user) to add them programmatically. The `user_id` property property can be retrieved from the [List account users API](https://developers.savvycal.app/api/list-account-users), or by copying it directly from the [Settings → Members & permissions](https://savvycal.app/users) page. To sign the user in, redirect the browser to the dashboard session `url` returned in the response. ## Example Flow 1. User clicks a button in your application to "Manage appointments". 2. Your application receives this request and creates a dashboard session via the API. 3. Your application redirects the user to the dashboard session URL. 4. The user is automatically signed in to the dashboard and redirected to the home screen.