This post contains outdated information. For the most current guidance, see: Microsoft Advertising API transition: SOAP to REST | Microsoft Community Hub.
Microsoft Advertising is evolving its API platform to better meet modern developer needs. As part of this shift, we’re transitioning from the SOAP API to a REST-based architecture that offers improved performance, flexibility, and ease of use.
If you’re currently using the SOAP API, now is the time to start planning your migration.
What’s changing
We’re standardizing on REST APIs as the foundation for all future Microsoft Advertising API development.
- Beginning October 1, 2026, new API features and enhancements will be available only through the REST API.
- The SOAP API will be fully deprecated on January 31, 2027.
During the transition period, your existing SOAP integrations will continue to run without interruption. This gives you time to plan, test, and complete your migration.
If you have a complex or large-scale integration and need additional time, contact your account team or Microsoft Advertising support to discuss an extended migration plan.
Why move to the REST API
The REST API provides a more modern and efficient integration experience:
- Access to new features and ongoing enhancements
- HTTP/JSON architecture aligned with industry standards
- Simpler integration and debugging
- Support across a wide range of programming languages
- Smaller message sizes with HTTP compression, reducing latency and traffic
How to get started
The best migration approach depends on how you’re currently integrated.
If you use an SDK
Start with the SDK migration guide to move from SOAP to REST while staying aligned with future updates.
If you call the SOAP API directly
Update your implementation to use REST endpoints and request formats. You can find endpoint details and request examples in the API reference documentation.
Not using an SDK today? This is a good opportunity to adopt one. SDKs simplify migration now and make future updates easier.
Plan your migration now
While there’s no immediate impact to existing SOAP integrations, key milestones are approaching quickly:
- October 1, 2026 → New features become REST-only
- January 31, 2027 → SOAP API is fully deprecated
Starting early will help ensure a smooth transition and uninterrupted access to the latest capabilities.
We appreciate your partnership and are committed to supporting you through this transition. The REST API unlocks new possibilities, and we’re excited to help you take advantage of them.
Microsoft