@devries-cameron20 / composio Mirror · read-only
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 04:45 UTC

next
md 5.72 KB

How do I set up custom OAuth credentials for Microsoft Advertising?

Microsoft Advertising has no Composio-managed app, so you need your own Microsoft Entra ID app registration and a production developer token to connect it.

Create the Microsoft Entra app

  1. Sign in to the Azure portal, open App registrations, and click New registration.
  2. Enter a Name. Under Supported account types, choose Accounts in any organizational directory and personal Microsoft accounts (shown as Any Entra ID Tenant + Personal Microsoft accounts). Microsoft's Advertising app registration guide calls for this option, and Advertising accepts both work or school and personal Microsoft identities.
  3. Under Redirect URI, select the Web platform, enter https://backend.composio.dev/api/v1/auth-apps/add, and click Register.

Entra Register an application form with Any Entra ID Tenant + Personal Microsoft accounts, the Web platform and the Composio redirect URI

  1. On the app's Overview page, copy the Application (client) ID.

Entra app Overview page with the client, object and tenant IDs censored

  1. Open Certificates & secrets and click New client secret. Add a description, choose an expiry that fits your rotation policy (for example, 180 days), and click Add. Rotate the secret before it expires.

Add a client secret panel with a description and the 180-day expiry

  1. Copy the secret Value right away. Use the Value, not the Secret ID. Azure shows the full value only once; if you lose it, create a new secret.

Client secrets list with the Value and Secret ID columns censored

  1. Keep Allow public client flows disabled on the Authentication page. This is a confidential Web client.
  2. Sign in to Microsoft Advertising developer settings with a Super Admin account and copy the production Developer token (request one if you don't have it). It is separate from the client secret. Sandbox tokens don't work with this toolkit. Don't regenerate a working token just to add another connection.

Microsoft Advertising Developer settings page with the developer token censored

The redirect URI you register must exactly match the oauth_redirect_uri field in your Composio auth config (default https://backend.composio.dev/api/v1/auth-apps/add).

Create the auth config in Composio

  1. In the Composio dashboard, go to Auth Configs, click Create, and select Microsoft Advertising. Enter a config name and click Next.

Composio Auth Configs page with the Create button

Create Auth Config dialog with Microsoft Advertising selected

Auth config name field with the Next button

  1. Select OAuth 2.0 and Your Own Credentials. Paste the Application (client) ID into Client id and the secret value into Client secret. Leave Redirect URI as shown.

Composio OAuth 2.0 form with empty Client id and Client secret fields and the v1 redirect URI

  1. Under Scopes, select the same permissions you added in Azure, then click Create Auth Config.

Composio auth config with the v1 redirect URI and the msads.manage and offline_access scopes

  1. Open the auth config and click Connect Account. Paste the production developer token (generic_secret), not the client secret, and click Connect Account. Sign in with the Microsoft identity that is already a user of the advertising account, complete any MFA, and review the consent prompt before accepting.

Microsoft Advertising auth config page with the Connect Account button

Composio connection form with an empty Developer Token field

Microsoft Pick an account page with the accounts censored

Microsoft consent prompt for Microsoft Advertising API access and continued access

  1. Back on the auth config's Connected Accounts tab, confirm the account shows Active. The Enabled label at the top of the page describes the auth config, not the account.

Connected Accounts tab with the Microsoft Advertising account showing Active

For the general flow, see custom auth configs.

Scopes

The default auth config requests https://ads.microsoft.com/msads.manage and offline_access. The connected identity's Advertising account roles still decide what it can view or change. See Microsoft's OAuth consent guide.

Why do I get AADSTS650052?

For an organizational identity, Microsoft can require tenant-admin setup before Advertising authorization works. Ask the tenant admin to review the Application behavior section of Microsoft's Advertising app registration guide.