Webhooks are a lightweight solution for pushing data from one app to another. Triggered by an event, the app sends a predefined dataset as an HTTP request to a URL (endpoint) of your choice.

Here’s what we cover in this article:

• How ChartMogul webhooks work
• Registering up a webhook
• Viewing the status and history of a webhook 
• Retrying a webhook 

How ChartMogul webhooks work

ChartMogul webhooks allow you to send MRR movements as a JSON payload. Real-time MRR movements serve as the events that trigger the webhook.

An MRR movement is the increase or decrease in a subscription’s MRR that results from a change made to the subscription (a subscription event). For example, when a customer upgrades to a higher plan (the subscription event), the increase in the customer’s monthly cost (e.g., $50) is the MRR movement. Learn more.

When webhooks are not triggered

Webhooks in ChartMogul are not triggered:

• When an MRR movement isn't real-time.
• For App Store Connect, as ChartMogul doesn't receive data in time to generate real-time MRR movements.
• When a change to a subscription doesn’t change its MRR, e.g., when a customer switches to a new plan with the same price.
• When you change a customer’s historical MRR by merging customers, editing MRR, or connecting subscriptions. Read more.
• When you manually add, edit, or delete data (e.g., customers, invoices, transactions, etc.) directly within a source’s tables.
• When ChartMogul reimports a customer, e.g., due to a failed invoice or when multiple transactions have failed.

Registering a webhook

Register a webhook in ChartMogul as a destination:

1. Navigate to Data Platform > Destinations.
2. Click Add a Destination.
3. Select Webhook.
4. Enter a unique name for your webhook in the Name field and click Next.
5. Enter the URL for your webhook in the URL field and click Update.
   
   ChartMogul currently allows you to register a webhook without a URL. Doing so, however, prevents you from registering further webhooks. So, don’t click Update without entering a URL.

Your new webhook will appear in the Destinations table. Edit or delete it by clicking the Settings   icon.

Viewing the status and history of a webhook

1. Navigate to Data Platform > Destinations.
2. View a webhook’s status in the Last Export Status column:
   
   • Succeeded — the URL returned an OK status (HTTP code 2xx)
   • Failed — the URL returned a status other than OK (HTTP codes 1xx, 3xx, 4xx, or 5xx)

When ChartMogul receives anything other than an OK status (HTTP code 2xx), it retries sending the webhook, up to 17 times. After 17 attempts, if the URL endpoint hasn’t returned an OK status, ChartMogul stops retrying and displays Failed in the webhook’s Last Export Status column. Follow the steps in the next section to retry webhooks manually.

Retrying a webhook

To have ChartMogul retry sending your webhook:

1. Navigate to Data Platform > Destinations.
2. Find and select your webhook.
   
3. In the Webhooks table, find and select a recent MRR movement ChartMogul has sent or attempted to send to the webhook’s URL.
   
4. Finally, click Retry.