What do I do if I want to change the scopes my application requests?

To use Calendar Access modes, you’ll need to be requesting the free_busy_write scope when authorizing a user’s calendar via Individual Connect or for Enterprise Connect if your application doesn’t do so already.

If your application is not requesting free_busy_write scope, you will need to update the requests you are making when Requesting Authorization with this scope:

Individual Connect #

Required Scope: free_busy_write

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

Enterprise Connect #

Required Delegated Scop: free_busy_write

Required Scope: service_account/accounts/manage

    https://app.cronofy.com/enterprise_connect/oauth/authorize
    ?response_type=code
    &client_id={CLIENT_ID}
    &redirect_uri={REDIRECT_URI}
    &scope=service_account/accounts/manage
    &delegated_scope=free_busy_write
    &state={STATE}

Once your application begins using the free_busy_write scope users will be presented with Calendar Access mode authorisation screens. They’ll then be able to choose which access mode they’d like to connect their calendars with.