Webhooks

Configure webhooks to receive real-time notifications when processing completes.

Setting Up Webhooks

  1. Log in to your dashboard at platform.mippia.com

  2. Click Callback URL

  3. Prepare your webhook endpoint URL

  4. Enter your webhook endpoint URL

  5. Save and verify

Preparing Your Endpoint

Your endpoint must handle a challenge verification request. When you register a callback URL, MIPPIA sends the following POST request to your endpoint:

Request from MIPPIA:

POST /your/webhook/endpoint HTTP/1.1
Content-Type: application/json

{
  "challenge": "generated-code-from-MIPPIA",
  "type": "url_verification"
}

Your endpoint must respond:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "challenge": "generated-code-from-MIPPIA"
}

Once your endpoint returns the correct challenge value, registration is complete.

Webhook Security

All webhook requests include an X-MIPPIA-Signature header for verification.