Introduction

To automate the creation and updates of new subscriptions, it is recommended that you implement a subscription Webhook API within your application and utilize the Marketplace Elements Webhook API. By automating the communication, you ensure that subscriptions in your SaaS product are always up to date with subscriptions in both Marketplace Elements and Azure. It also reduces the overheads involved in manually processing subscriptions, allows your subscribers to use your SaaS product as soon as they complete the sign-up process and to start the billing process for each subscription immediately.

The following document describes the structure of the requests and payload that will be sent to your SaaS product when a new subscription has been created or a change has been made to an existing subscription. This includes suspensions and cancellations. Also provided are recommendations, and example code for different technologies, on how to implement your SaaS’s subscription API to securely utilize the messages received.

The document also describes how to send requests to the Marketplace Elements API to make changes to a subscription or create a usage event in both Marketplace Elements and Azure, from your SaaS product or automated services.