Request authorization PRERELEASE

Required plan: Emerging

Description #

When Business Connect is enabled for your application, you may request the ability to access other calendars through the user’s account.

This is achieved by adding an additional delegated_scope parameter to your Account Authorization request.

This will issue you a short-lived, single-use code that you will be able to exchange for an access_token and refresh_token for the user, along with enabling your application to make Delegated Authorization requests using their account.

Example request URL #

The parameters are encoded in the querystring as specified in appendix B of RFC 6749. Additional linebreaks are added to the request’s path for clarity.

https://app.cronofy.com/oauth/authorize
    ?response_type=code
    &client_id={CLIENT_ID}
    &redirect_uri={REDIRECT_URI}
    &scope={SCOPE}
    &delegated_scope={DELEGATED_SCOPE}
    &state={STATE}

Request URL parameters #

In addition to the standard authorization parameters, you must specify:

delegated_scope required  #

The scope of delegated privileges you want the eventual access_token to grant for other accounts. One of the following scopes must be requested:

  • free_busy
  • read_only

free_busy will allow your application to access availability information for other calendar accounts. read_only will allow your application to access the schedule of other calendar accounts.