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 a webhook
• Viewing the status and history of a webhook 
• Retrying a webhook 

How ChartMogul webhooks work

Configure webhooks as one of ChartMogul’s standard destinations to send MRR movements as a JSON payload. Real-time MRR movements serve as the events that trigger the webhook.

Learn more about webhooks and data contained in the JSON payload on our Developer Hub.

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 an MRR movement is below 0.5% of the total MRR or five cents (pence, centavos, etc.).
• When you only provide the date of a subscription event or transaction and the default time (midnight) falls outside of the 12-hour window for the MRR movement to be considered real-time.
• When ChartMogul reimports a customer, e.g., due to a failed invoice or when multiple transactions have failed.

IP allowlisting

ChartMogul webhooks use the following IP addresses. For your integration to work, you may need to allowlist them in the application that receives webhook data.

• 3.248.174.47
• 99.80.87.208
• 34.248.167.65


Registering a webhook

Register a webhook in ChartMogul as a destination:

1. Navigate to Settings & Data > Destinations.
2. Click Add Destination.
3. Select Webhook.
4. Enter a unique name for your webhook in the Name field.
5. Enter the URL for your webhook in the URL field and click Update.

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 Settings & Data > 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.