We’re introducing an important security update to Microsoft Advertising account linking APIs to better protect customer accounts and prevent unauthorized access.
This change applies only to new linking requests. Existing links and pending requests aren't affected.
What’s changing
To create or accept an account linking request, you must now provide two identifiers instead of one:
- For manager account linking (CID):
- Manager account number (alphanumeric)
- Manager account ID (numeric)
- For account linking (XID):
- Manager account number (alphanumeric)
- Account number (alphanumeric)
Why this change matters
We’ve strengthened the account linking process to reduce the risk of unauthorized access and fraud.
Previously, linking could be initiated using a single identifier, which increased exposure to brute-force attempts. The new dual-ID requirement helps:
- Improve overall account security.
- Block most fraudulent linking attempts.
- Maintain a high success rate for legitimate use cases.
What you need to do
Update your integration to ensure:
- Both required identifiers are included in all linking API calls.
- Values are validated to match the correct target account.
- Your workflows handle errors for missing or mismatched IDs.
Timeline
Enforcement begins August 26, 2026, and will roll out gradually.
To avoid disruption:
- Update your API calls to include both identifiers before August 26, 2026.
After enforcement begins, any new linking requests that do not include both IDs will be rejected.
Support
We recommend prioritizing these updates early to avoid disruption to your workflows.
If you have questions or need assistance, contact your Microsoft Advertising account team or reach out to Microsoft Advertising support.