Explanation
When connecting your Microsoft Ads account to Tracify, you may see an error indicating that your organization lacks a service principal for the Microsoft Advertising API.
In simple terms, your organization's Microsoft account doesn't yet recognize the Microsoft Advertising API as an approved connection. The fix below registers it so that Tracify can access your ad data on your behalf.
In technical terms, your Entra (Azure AD) tenant doesn't have the Microsoft Advertising API registered as a known service, which is required for Tracify to request advertising permissions.
This is a one-time setup step. Once resolved, it won't recur.
Who can fix this?
You'll need someone with admin-level permissions in your organization's Microsoft Entra tenant - specifically Global Administrator, Cloud Application Administrator, or Application Administrator. A regular user account won't have sufficient permissions.
Finding your Tenant ID
You'll need your Entra tenant ID for the steps below. You can find it by signing into the Microsoft Entra admin center and looking under Overview, or by going to Azure Portal > Azure Active Directory > Overview. It's a GUID in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
Option 1: Azure CLI
Install Azure CLI
macOS:
brew install azure-cliWindows:
winget install Microsoft.AzureCLIor download from https://learn.microsoft.com/en-us/cli/azure/install-azure-cli-windowsLinux:
curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash
Run the following commands
# Sign into your Entra tenant as an admin az login --tenant {your-tenant-id} --allow-no-subscriptions # Create the Microsoft Advertising API service principal az ad sp create --id d42ffc93-c136-491d-b4fd-6f18168c68fdYou should receive a JSON response containing "appDisplayName": "Microsoft Advertising API Service" and "accountEnabled": true. This confirms the service principal was created successfully.
Option 2: PowerShell
If you already have the Azure PowerShell module installed:
# Sign into your Entra tenant Connect-AzAccount -TenantId {your-tenant-id} # Create the Microsoft Advertising API service principal New-AzADServicePrincipal -ApplicationId d42ffc93-c136-491d-b4fd-6f18168c68fd
After completing any option
Return to Tracify and retry connecting your Microsoft Ads account. The connection should now complete successfully.
If you still encounter an error, take a screenshot of the error page and copy the full URL from your browser's address bar, then share both with Tracify support.