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

# Microsoft Ads: Connect the account

## Step 1: Complete Requirements

Before connecting, please ensure the following:

<br />

#### Requirement 1: Verify the Microsoft Advertising API Service for your Azure Tenant

1. Please reach out to your Microsoft Azure Active Directory administrator and ensure that you have at least one of the admin users from your Azure AAD tenant added and enabled for work accounts in the Microsoft Advertising web application, and that the Microsoft Advertising API Service (App ID: d**42ffc93-c136-491d-b4fd-6f18168c68fd**) is active with **msads.manage** and **ads.manage** permissions.

#### Requirement 2: Enable User Consent in Microsoft Entra

1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as a Global Administrator.
2. Navigate to Identity → Applications → Enterprise Applications → Consent and permissions → User consent settings.
3. Choose one of the following settings:
   1. Allow user consent for apps from verified publishers, for selected permissions
   2. Let Microsoft manage your consent

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/northbeam/images/readme/028846a4-image_11.png" alt="" />
</Frame>

<br />

#### Requirement 3: Confirm Business Microsoft Account

Confirm your account is a **Business Account**, not a Personal Account.

To confirm your account type:

1. In the Microsoft Ads portal, go to **Settings > My Settings > Signed In With**.
2. If your account is set to Personal, follow the link provided there to switch to Business.

***

## Step 2: Connect Your Microsoft Ad Account

Northbeam natively integrates with the Microsoft Ads API. By doing so, we pull all your current and historical Campaigns, Adsets, and Ads from your account, along with a list of useful metrics. Notably, we pull impressions, which fuel our view model and unlock our Clicks + Modeled Views attribution model.

* **Onboarding Flow** - Navigate to **Integrations**
* **Activated Dashboard** - Go to **Settings > Connections**

For a visual walkthrough, reference the video below.

<Frame>
  <iframe src="https://www.loom.com/embed/d1d83910b47b48eeba950e9b46a38aaa?sid=549b5b43-b6a8-4cb4-8485-2da14cc057dd" width="100%" height="450" allowfullscreen />
</Frame>

<Warning>
  Connection Errors

  If you attempt to connect your ad account and see an error message, please troubleshoot below:

  * **Error 105** - This is a permissions error. Please to enable 3rd party access on their Microsoft account. See Requirement #1 above.
  * **Error 106** - This is an account type error. Please connect using a business Microsoft account, rather than a personal account. See Requirement #2 above.
</Warning>

<Tip>
  Once your account is connected, you're all set!
</Tip>

***