Get started with the Hotel API


This beta release of Hotel Price Ads is available to select participants only. For information about participating in the beta release program, please contact your account manager or enroll here.

The API and documentation are subject to change.

Do you have your Microsoft Advertising credentials?

To use the Hotel API, you must have a Microsoft Advertising account and a Microsoft account. To get a Microsoft Advertising account, go to If you're not signed in using your Microsoft account, you're asked to sign in to your Microsoft account or sign up for a Microsoft account. After signing in, you'll have the option to Sign up for a new Microsoft Advertising account. Select the sign-up option and continue with the sign-up process.

Unlike the other Bing Ads APIs, the Hotel API does not use a developer token. The API ignores it if you include it.

Enable your account for Hotel Price Ads

Once we have received your enrollment information, we will contact you via email regarding the next steps.

Authenticating your credentials


Starting June 1st, 2022 we will require multi-factor authentication for all users who sign in through a third-party application that uses the Bing Ads API, Content API, and Hotel APIs.

You must update your application to get user consent using the new msads.manage scope. All application developers must take action to use the new scope.

For more information see the Multi-factor authentication requirement guide.

The Hotel API uses the OAuth authentication scheme. For details about authenticating Microsoft account credentials using OAuth, see Authentication with OAuth (using the Microsoft identity platform is recommended).

You can use the Bing Ads SDK for .NET, Java, or Python to authenticate Microsoft account credentials. For details about using the SDK to get the access token, see C# | Java | Python. You might only want use the SDK to get the access token if you're using the SDK for Microsoft Advertising campaigns, too. Otherwise, it may not be worth the overhead of installing the SDK.

If you choose not to use the Bing Ads SDK to get the tokens, see OAuth C# Example for an example OAuth implementation.


If you use the API from a service, see Using the Hotel API from a service.

Authenticating your credentials in sandbox

For the sandbox environment, the following are the endpoints you must use to get Microsoft accounts and your application's client ID. Wherever you see endpoints mentioned in Authentication with OAuth, substitute them with the following sandbox endpoints.

  •—Endpoint for the Hotel API's sandbox
  •—Endpoint for getting a sandbox Microsoft account
  •—Endpoint for sandbox email used when getting a sandbox Microsoft account
  • Skip the step to register an app. Sandbox does not support app registration. Instead, use the "Tutorial Sample App" client ID, which is 4c0b021c-00c3-4508-838f-d3127e8167ff. This client ID is for desktop apps only and may not be used for testing web apps.
  •—Endpoint for OAuth requests

Getting sandbox credentials

Get a sandbox account if you don't already have one

You use the sandbox environment to test your application before putting it in production. Use the following steps to get a sandbox account.

  1. Open a browser and navigate to
  2. Click Sign up for Microsoft Advertising or Sign up now.
  3. Fill out the Create Account form.
  • Choose the Create a new email address option.

  • Enter an MSA email address. The email server must be (for example,


    Sandbox supports MSAs created using an email account only. You may not use an email account. Also, you may not use an email account from another email service (for example, even if the account is linked to an or email account.

  • Finish the work flow by specifying the rest of your user information.

  1. For Import/Create Campaign, click Skip campaign creation
  2. For Go Live, click Skip payment information

After creating your sandbox account and getting your MSA, let your account manager know so they can enable it for Hotel Price Ads. You won't be able to use Hotel Price Ads or the API in sandbox until it's enabled.


The MSA signup process returns you to the SI Microsoft Advertising user interface ( After completing the MSA process, sign out of the SI interface. To access Hotel Price Ads using the Microsoft Advertising user interface in sandbox, go to and sign in using your new MSA email address.

Where do you use your credentials?

After getting the user's OAuth access token, set the Authorization header to it.

var headers = new WebHeaderCollection();
headers.Add(HttpRequestHeader.Authorization, "Bearer " + tokens.AccessToken);

For information about the Authorization header and other headers that the request and response may contain, see Headers.


The Hotel API uses the standard Authorization header. If you use the Bing Ads SDK to get the OAuth tokens, you'll use the SDK to get the tokens and then set the Authorization header.

Do you have your hotel feed set up?

Before using the Hotel API, you should have your hotel feeds set up. For details, see: