Skip to main content

Get Channel Authorization URL

GET 

/gds/vendor/channels/:channel_id/authorization

  • Airbnb only. It applies to channels whose channel metadata sets requires_cms_authorization to true, which today means Airbnb alone. Calling it for any other channel returns 403.
  • Airbnb requires OAuth approval from the host account for each property. Use this API to obtain an authorization URL, send the host there, and wait for approval before proceeding with room type and rate plan mappings.
  • Once the host finishes authorizing, they return to redirect_url with ?auth_result=success|fail appended.
  • auth_result is a display hint only. Judge completion by whether channel_property_id is present in the property mapping.
  • An issued authorization URL must be used within one hour; once it expires you must issue a new one. Issue it at the moment the host presses the button.
  • Authorization is per property, so a host account operating several properties must repeat it for each one.

Request​

Responsesapplication/json​

Channel authorization URL retrieved