Get Channel Authorization URL
GET/gds/vendor/channels/:channel_id/authorization
- Airbnb only. It applies to channels whose channel metadata sets
requires_cms_authorizationtotrue, which today means Airbnb alone. Calling it for any other channel returns403. - 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_urlwith?auth_result=success|failappended. auth_resultis a display hint only. Judge completion by whetherchannel_property_idis 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
- 200
- 400
- 401
- 403
- 404
- 500
Channel authorization URL retrieved
Bad Request
Unauthorized
Forbidden
Not Found
Internal Server Error