Organization Connect

Read as Markdown Required plan: Scheduler

Description #

Organization Connect allows your application to gain access to a user’s Organization Account (their Cronofy Organizational Unit). For example this allows your application to create Scheduling Requests on behalf of users and/or use calendar event end-points to add events to their calendars.

For single-tenant applications, ie for internal use, you create an Internal Application that is granted full access to the Organization configuration.

Organization Connect is used for multi-tenant applications where you want your application to connect with the Cronofy Organizational Units of your customers.

Authorization to access a user’s calendars is done via the OAuth 2.0 protocol, Specifically the “Authorization Code” version of authorization as specified in section 4.1 of RFC 6749.

Find out more in our Authorization introduction.

In this section

Request Authorization

In order to perform actions on behalf of a user, they must first authorize you to do so.

Request an Access Token

Access Tokens are issued as specified in section 4.1.3 of RFC 6749, authentication is performed by including your client_id and client_secret, as issued by Cronofy, within the body of the request.

Refresh an Access Token

Access Tokens are refreshed as specified in section 6 of RFC 6749, authentication is performed by including your client_id and client_secret, as issued by Cronofy, within the body of the request.

Revoking Authorization

You should revoke your access on behalf of your users rather than directing them to our site, for example when they unsubscribe from your service or no longer want to use your calendar integration features.