Get Started Using Java with Bing Ads Services

To get started developing Bing Ads applications with Java, you can start with the provided examples or follow one of the application walkthroughs for a Web or Desktop application. The examples have been developed with the Bing Ads Java SDK and run with the Eclipse Java EE IDE for Web Developers, Luna Service Release 1 (4.4.1). For Eclipse downloads, see Your custom configuration may vary.

You will need user credentials with access to Bing Ads either in production or sandbox. For the production environment you will need a production developer token. All sandbox clients can use the universal sandbox developer token i.e., BBD37VB98. For more information, please see Get Started With the Bing Ads API and Sandbox.

To authenticate with a Microsoft Account (email address user name) in production, you must also must register an application and get the corresponding client identifier. You also need to take note of the client secret and redirect URI if you are developing a web application. For authentication details, see Authentication With the SDKs.

Install the SDK

The Bing Ads Java SDK depends on the libraries listed at the Maven Repository.

When you create a Maven project and include the microsoft.bingads Maven artifact as shown below, additional dependencies are installed automatically. If you are not using a Maven project, you must include the correct version of each dependency. For more information, please see the Walkthrough: Bing Ads Web Application in Java or Walkthrough: Bing Ads Desktop Application in Java application examples.

<project xmlns="" xmlns:xsi="" xsi:schemaLocation="">


Version 11.12.1 is included as an example. For details about the latest SDK dependency version, please see the Bing Ads Java SDK GitHub


Once you have the Bing Ads Java SDK installed, you can either browse the Bing Ads Code Examples, download the examples from GitHub, or follow one of the application walkthroughs for a Web or Desktop application.

See Also

Bing Ads Client Libraries
Bing Ads Code Examples
Bing Ads Web Service Addresses
Handling Service Errors and Exceptions