Skip to main content
You need Super Admin access to the Microsoft Advertising account to request or view a developer token.

Retrieve your account values

The Developer Token identifies the application calling the Microsoft Advertising API. The Customer ID identifies the manager (customer) account, and the Account ID identifies the ad account being managed.

1

Request a developer token

Sign in to Microsoft Advertising, then open Settings > Developer settings.

  • If a token is already shown under Developer token, skip this step.
  • Choose the account under Select user.
  • Review the Microsoft Developer Services Agreement.
  • Click Request Developer Token.
Microsoft Advertising Developer settings page with the Request Developer Token button highlighted (shown when no token exists yet)
2

Copy your developer token

On the Developer settings page, copy the Developer token across.

Microsoft Advertising Developer settings page with the issued Developer token value highlighted (redacted)
3

Copy the IDs from the URL query string

Open the account you want to manage in Microsoft Advertising. The URL query string in the browser address bar contains both IDs.

  • Copy the cid across to Customer ID.
  • Copy the aid across to Account ID.
  • Format: https://ui.ads.microsoft.com/campaign/vnext/...?cid={customerId}&aid={accountId}
  • Example: https://ui.ads.microsoft.com/campaign/vnext/overview?cid=251243063&aid=141534522
1

Connect

  • Click Connect.
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup.
2

Use Actions

Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.