Required plan: Starter

Description #

When you wish to allow an end-user to authorize access to their conferencing services, you use this endpoint to generate a URL to redirect them to. This will ensure that the authorization is linked to the correct Cronofy Account.

URL format #


Example Request #

POST /v1/conferencing_service_authorizations HTTP/1.1
Host: {data_center_url}
Authorization: Bearer {ACCESS_TOKEN}
Content-Type: application/json; charset=utf-8

    "redirect_uri": ""

Example Response #

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

    "authorization_request": {
        "url": ""

The user should be redirected to the given URL by your application in order for them to authorize access to their conferencing service.

Request parameters #

data_center_url required

The URL for the data center you want to communicate with. Possible choices are:

  • - πŸ‡¦πŸ‡Ί Australia
  • - πŸ‡¨πŸ‡¦ Canada
  • - πŸ‡©πŸ‡ͺ Germany
  • - πŸ‡ΈπŸ‡¬ Singapore
  • - πŸ‡¬πŸ‡§ United Kingdom
  • - πŸ‡ΊπŸ‡Έ United States

Find out more about Cronofy's data centers.

redirect_uri required  #

The redirect_uri is the page which the user will be directed to after they have granted or rejected authorization.

Note that if the user rejects the request a query string value of error=access_denied will be added to the URL before they are redirected to it.

provider_name optional  #

A String value indicating a conferencing service provider to pre-select for the user.

Currently supported options are:

  • ms_teams Microsoft Teams
  • go_to GoTo Meeting
  • zoom Zoom