Webhooks

Webhooks (Web Callback, HTTP Push API, or Reverse API) are a method for one web application to transmit messages to the other application in real-time when a predefined event takes place. TagMango's webhooks allow you to receive information about specific events based on parameters of the event.

How Webhooks Work

When an event occurs (like a student reaching 50% course progress), TagMango sends an HTTP POST request to your configured webhook URL with the event data.

Getting Started

1. Set up a webhook endpoint on your server
2. Configure the webhook URL with the Register Webhook API
3. Handle the incoming webhook events in your application

Registering Webhook

In order to register a webhook on TagMango follow the following steps:

1. Retrieve your API Key from TagMango dashboard by going to Dashboard → Platform Integrations (any of them will work).
2. Use the key to hit the Register Webhook API endpoint listed below.

Testing

You can test your webhook implementation using tools like:

• ngrok for local development
• webhook.site for testing
• Postman for manual testing

Handling Webhooks

Your webhook endpoint should:

1. Respond with 200 — Return a 200 HTTP status code to acknowledge receipt
2. Process quickly — Respond within 30 seconds to avoid timeouts
3. Implement idempotency — Handle duplicate events gracefully
4. Verify authenticity — Validate the request using the provided authentication headers

Troubleshooting

Common Issues

1. Webhook not received

   • Check if your endpoint is publicly accessible
   • Verify the webhook URL is correct
   • Ensure your server responds within 30 seconds

2. Authentication failures

   • Verify API key is correct
   • Check authentication header implementation

3. Duplicate events

   • Implement idempotency using event-specific identifiers
   • Store processed events to avoid duplicate processing