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

# Webhooks

Partner Ecosystem Management allows Merchants with [Platform-Managed products](.) to subscribe to Partner Ecosystem Management webhooks in the **Platform Settings** space.

A webhook, or a web callback, is a way for Partner Ecosystem Management to provide Merchants with real-time information about Partner subscription provisioning and fulfillment events. Possible events include creating, updating, and deleting Partner subscriptions.

Webhooks can be more efficient than polling for updates. To get data, all Merchants need to do is [subscribe to the webhook](m_webhooksManage). After the configuration, Partner Ecosystem Management sends the events to the endpoint URL. Merchants get updates as they happen.

Partner Ecosystem Management enables Resellers (Service Providers) using the [Platform-Managed product lifecycle](.) to receive real-time updates through webhooks. These updates are triggered by events related to [subscriptions](.), [Partner subscriptions](.), and external catalog changes.

Subscribing to webhooks is required when using the [Platform-managed](g_platformManagedFlow) product lifecycle. For Resellers using Commerce Engine and Storefront Gateway, it is mandatory to subscribe to all Partner subscription and subscription events to ensure proper integration and real-time updates.

**What Are Webhooks?**

A webhook (or web callback) is a way for Partner Ecosystem Management to send real-time event notifications to Resellers. Instead of polling for updates, Resellers can [configure a webhook endpoint](m_webhooksManage) to automatically receive event data as it happens.

**Why Use Webhooks?**

Webhooks provide:

* Real-time updates on subscription, Partner subscription, and catalog changes.
* Improved efficiency over polling APIs.
* Custom routing of specific event types to different URLs, enabling more targeted processing.

## Events

When you subscribe to a webhook, you can select which Partner Ecosystem Management events to receive. For example, you can be notified when a subscription is created, canceled, or both.

You can subscribe to any of the following events:

| Event Name | API Action Value | Description |
| - | - | - |
| Add subscription | `AddSubscription` | Partner Ecosystem Management sends this event when the customer purchases a subscription from the Reseller's (Service Provider's) website, or a subscription needs to be re-provisioned. **Note:** It is expected that the Merchant performs any applicable provisioning if the callback is configured via the **Platform Settings** in Partner Ecosystem Management, and returns the mandatory fields described in the [OTT Service Callbacks](https://docs.saas.amdocs.com/bundle/MarketONEOTTServiceCallbacks/page/index.html). |
| Add multiple subscriptions | `AddMultipleSubscriptions` | **Note:** Your system must be configured to use this request. Partner Ecosystem Management sends this event when the customer purchases multiple subscriptions from the Reseller's (Service Provider's) website or when the subscriptions need to be re-provisioned. |
| Update subscription | `UpdateSubscription` | Partner Ecosystem Management sends this event when the customer upgrades or downgrades the service subscription via the Reseller's (Service Provider's) website.**Note:** The Merchant should handle this action to allow for any applicable provisioning. |
| Delete subscription | `DeleteSubscription` | Partner Ecosystem Management sends this event when the customer cancels the subscription or the subscription is no longer valid based on the status of the customer's billing account.**Note:** The Merchant must handle this action to allow for any applicable de-provisioning. |
| Update subscription metadata | `UpdateSubscriptionMetadata` | Partner Ecosystem Management sends this event when any metadata associated with a subscription is changed on the Reseller's (Service Provider's) side, such as a phone number. |
| Pause subscription | `PauseSubscription` | Partner Ecosystem Management sends this event when a customer's subscription is paused from the Reseller's (Service Provider's) side for a variety of reasons, such as non-pay scenarios. |
| Resume subscription | `ResumeSubscription` | Partner Ecosystem Management sends this event when a customer's subscription is resumed from the Reseller's (Service Provider's) side. |
| See the [OTT Service Callbacks](https://docs.saas.amdocs.com/bundle/MarketONEOTTServiceCallbacks/page/index.html) for more details. | | |

You can also configure a single webhook endpoint to handle multiple events. This can be useful when different systems are responsible for processing different events, allowing you to route events appropriately.

<img src="https://mintcdn.com/amdocs-spbu/-GCj74mr5p4KPy3T/marketONE/merchantOnboardingGuide/images/Webhooks.png?fit=max&auto=format&n=-GCj74mr5p4KPy3T&q=85&s=d5813c274d65c4e9149fae8369b49da1" alt="Webhooks Page" width="1708" height="846" data-path="marketONE/merchantOnboardingGuide/images/Webhooks.png" />

* **[Set Credentials](m_webhooksAbout#set-credentials)**

* **[Manage Webhooks](m_webhooksManage)**

**Parent topic:**[Step 2: Technical Access and Setup in the Sandbox Environment (PDT)](technicalAccessAndSetup)

## Set Credentials

Partner Ecosystem Management supports various methods to secure your webhook events. Setting up an authentication method is optional but recommended to increase the security of the webhook event data. It ensures the communication is only between partnered Resellers (Service Providers), Partner Ecosystem Management, and the Merchant.

You must select one of the following options:

* **No credentials**

* **Username and password**

* **API key**

  Partner Ecosystem Management passes your API key into REST API calls as a header (`X-API-KEY`) to secure the connection.

* **OAuth2 access token**

  The endpoint URL verifies your access token when receiving notifications.

**Parent topic:**[Webhooks](m_webhooksAbout)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.