> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cometly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshoot a Microsoft Ads connection

> Fix the Microsoft Ads admin approval message when you connect Microsoft Ads to Cometly: why Microsoft asks for it and who can approve the connection.

You click **Sign in with Microsoft** to connect Microsoft Ads to Cometly, and Microsoft blocks the sign-in or shows a **Need admin approval** message instead of connecting. This page explains why Microsoft Ads admin approval is needed and how to get the connection approved.

You connect Microsoft Ads in Cometly from **Integrations**, under **Ad Platforms**, by expanding **Microsoft Ads** and clicking **Sign in with Microsoft**. Until that sign-in succeeds, Cometly cannot bring in your Microsoft campaigns or their spend.

If you sign in to Microsoft Advertising with a Google account, see [Microsoft Ads and Google single sign-on](https://docs.cometly.com/support/troubleshooting/integrations/microsoft-ads-google-sso.md).

## Why Microsoft sometimes asks for admin approval

Microsoft Advertising uses Microsoft's identity and security system.

Because of this, some organizations require **one-time approval from an IT or Microsoft admin** before a third-party tool like Cometly can connect.

This requirement is set by Microsoft, not Cometly.

## Common situations

### You see a "Need admin approval" message

![Microsoft sign-in dialog titled Need admin approval, saying Cometly needs permission only an admin can grant](https://mintcdn.com/cometly/tD3Mww01MPmE7a9V/images/support/troubleshooting/ad-data/microsoft-ads-connection/01.webp?fit=max\&auto=format\&n=tD3Mww01MPmE7a9V\&q=85\&s=6b30de8b0f43f364aeb674f328ed0d29)

If you see a message saying that admin approval is required, it means:

* You are signing in with a **work email**.
* Your company restricts third-party app access.
* A Microsoft admin must approve Cometly once.

> [!NOTE]
>
> Being a **Super Admin in Microsoft Advertising is not enough** to approve this.
>
> The approval happens at the **Microsoft Entra ID** level (from within the Azure portal), where the **Global Administrator** or **Application Administrator** role is needed.

The account admin can edit user permissions at [https://entra.microsoft.com/](https://entra.microsoft.com/).

A Global Administrator or Application Administrator then opens the **App registrations** service.

From the **App registrations** page, the admin should be able to find the Cometly app and approve it.

### It works with Gmail or Outlook.com accounts

If your Microsoft Advertising account is connected to one of these, you may be able to connect immediately:

* Gmail
* Outlook.com
* Hotmail

These accounts don't have the same restrictions as company-managed Microsoft accounts.

### You are a Microsoft Ads Super Admin but still blocked

Microsoft Advertising permissions and Microsoft admin permissions are different.

Even if you manage campaigns, users and billing in Microsoft Ads, Microsoft may still require approval from an IT admin.

## What access Cometly requests

When you connect Microsoft Advertising, Cometly requests two permissions:

* **Offline access**, to keep the connection active securely.
* **Manage your Microsoft Advertising account** (`msads.manage`).

Cometly uses that access to:

* Read and sync your Microsoft Advertising data for reporting and attribution.
* Apply the changes you make yourself in Cometly's **Ads Manager**: renaming a campaign or ad group, turning a campaign, ad group or ad on or off, and changing a campaign budget.
* Send conversions to Microsoft, if you turn on the [Conversion API for Microsoft](https://docs.cometly.com/guides/conversion-api/microsoft.md) (the Conversion API is Cometly's server-side feed of conversions to ad platforms).

## How to resolve the issue

If you see the admin approval message:

1. Ask someone on your team who manages Microsoft or IT access to approve Cometly. They need the **Global Administrator** or **Application Administrator** role in Microsoft Entra ID.
2. That admin approves the Cometly app from **App registrations**. This approval only needs to happen once.
3. Back in Cometly, open **Integrations**, expand **Microsoft Ads** under **Ad Platforms** and click **Sign in with Microsoft** again.

After approval, anyone on your team can connect Microsoft Advertising without issues.

If you are not sure who this person is, it is usually someone who:

* Manages Microsoft accounts
* Handles IT or security
* Sets up company email or Microsoft tools

## Confirm the connection works

When the sign-in goes through, the Microsoft window shows **Microsoft profile connected successfully.** Click **Done** to close it. The **Microsoft Ads** row then expands, and the **Ad Accounts** table lists the accounts your Microsoft user can access.

## Frequently asked questions

### What does "Microsoft authorization failed" mean when I connect Microsoft Ads?

Microsoft returned an error instead of granting access, and the rest of the message is Microsoft's own reason. Close the window, click **Sign in with Microsoft** again and accept the permissions Microsoft lists.

### Why is a Microsoft Ads account missing from the list in Cometly?

Cometly only lists the accounts that your Microsoft user has access to. Ask for access to the account in Microsoft Advertising, then click **Resync** on the **Microsoft Ads** row.

### How do I fix "Connection Issue, Resync Required" on Microsoft Ads?

That status means Cometly cannot load your ad accounts from Microsoft. Click **Resync** on the **Microsoft Ads** row and sign in to Microsoft again.

## Next steps

* [Connect your Microsoft Ads accounts to a space](https://docs.cometly.com/integrations/ad-platforms/microsoft.md) once the sign-in is approved.
* [Fix the connection when you sign in to Microsoft Advertising with Google](https://docs.cometly.com/support/troubleshooting/integrations/microsoft-ads-google-sso.md).
* [Configure the Microsoft Ads Conversion API](https://docs.cometly.com/guides/conversion-api/microsoft.md) to send your conversions back to Microsoft.
* [Check why ad data is not syncing](https://docs.cometly.com/support/troubleshooting/ad-data/ad-data-not-syncing.md) if the account is connected but no data appears.

Still have questions or need a hand? We're happy to help. Reach our team at [support@cometly.com](mailto:support@cometly.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.