Webhooks
Getting Started

Getting Started

Webhooks enable you to receive real-time notifications whenever specific events occur in our system. This allows you to automate workflows, update data, and respond to events immediately, seamlessly integrating Captino into your existing systems.

Step 1: Set Up a Webhook Endpoint

To receive webhooks, you’ll need to set up an endpoint on your server that can accept HTTP POST requests. This endpoint should:

  • Listen for incoming requests from our webhook service.
  • Process JSON payloads.
  • Respond with an HTTP 2XX status code when the webhook is received successfully.

Step 2: Register Your Webhook

To register a webhook, follow these steps:

  1. Log into your Captino account and navigate to the Webhooks section in your account settings.
  2. Click Add New Webhook.
  3. Enter the URL of the endpoint you set up in Step 1.
  4. Select the events you want to subscribe to (for example, funnel.created, etc.).
  5. Save the webhook. Once saved, Captino will start sending event notifications to the specified endpoint.

Timeouts and Retries

To ensure timely and reliable webhook delivery, Captino enforces a 5 second timeout for each webhook request. If we do not receive a successful response within 5 seconds, the webhook attempt is marked as failed, and we will automatically queue it for retry.

Retry Strategy

Captino retries failed webhook deliveries up to 10 times, employing an exponential backoff strategy to space out the attempts. This approach helps reduce the risk of overwhelming your server and increases the likelihood of successful delivery under temporary network issues. The interval between retries increases progressively as follows:

Retry NumberDelayTotal Time Elapsed
15s5s
210s15s
330s45s
41m1m 5s
55m6m 5s
610m16m 5s
730m46m 5s
81h1h 46m 5s
92h3h 46m 5s
104h7h 46m 5s