GET

List Connections


Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Retrieves a list of external calendar connections.

Each external calendar connections contains details of a connection between a Wix site's calendar and calendars hosted by an external provider.

The syncConfig property of each connection contains configuration details for importing events from an external calendar, exporting events to an external calendar, or both.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage Bookings - all permissions
Manage External Calendars
Learn more about app permissions.
Endpoint
GET
https://www.wixapis.com/bookings/v2/external-calendars/connections

Query Params
scheduleIdsArray <string>

Schedule IDs to filter by. If provided, only connections between external calendars and the specified schedules is returned.

Default: Returns all connections.


partialFailureboolean

Whether to return a partial list of connections if details can't be retrieved for some connections.

Default: false

Response Object
connectionsArray <Connection>

List of external calendar connections.


failedProviderIdsArray <string>

List of provider IDs for connections for which retrieval failed. Returned only if partialFailure body parameter is true in the request.

Request
cURL
curl -X GET 'https://www.wixapis.com/bookings/v2/external-calendars/connections' \ -H 'Authorization: <AUTH>'
Response
JSON
{ "connections": [ { "id": "4WnvD8QzxhkAjVPBKUCvLIMpbuuUCMID7rYhqOpIGDae9JYyQj0JS71sdJukve86B38sWvS6TOvMQqBxszjEMN7MfiUjvCwgx0inoCXpg7JpM0QXmxYW4E2dXHAmKaNKk4M5jez8KwwxQxUNygYrvR0V08GW0weMqwMW1GYslMM1kVPcGuiwqJ7", "providerId": "9f084ae8-b3a6-4eb6-a29d-bc682c04b5fc", "calendarType": "I_CAL", "scheduleId": "100ef23e-9e92-4293-8e08-d3747537138f", "userId": "f7f363b1-8ef8-4118-9612-0e6b3910745a", "externalAccountEmail": "some@email.com", "status": "CONNECTED", "syncConfig": { "listEventFromCalendars": { "enabled": true, "calendars": { "calendars": [ { "id": "2cnk4sgx4haqxbuz0sao0flxw" }, { "id": "4xve0tohyhnrlzy3lp4zf7b07" }, { "id": "a68yu6lp6584z66zorp19z1ab" } ] } } } }, { "id": "NKUjjvm8geI1xEEE6pU5of0blj4oIHvJy7M4KGCDHidQzOiHHWchOJ31inHqv3fCFo5mtX62Wp5PV4Kv5cTJRANJJbw1ukkwesjQVKeM7VAjq8ErrMDutLTq2dDvkUc0eFN36l3n1g45JWkAn1t8d", "providerId": "6c533722-f1f9-4847-95c7-d4c4922ae9b0", "calendarType": "GOOGLE", "scheduleId": "b936298d-18a6-4ae8-8e9f-10bf49314c95", "externalAccountEmail": "some-other@email.com", "status": "SYNCED", "syncConfig": { "listEventFromCalendars": { "enabled": true, "primaryCalendar": {} }, "syncToCalendar": { "enabled": true, "primaryCalendar": {} } } } ] }
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Did this help?