Webhook Configuration and Lifecycle

Understanding the lifecycle, configuration options, and best practices helps ensure reliable webhook integration with BoldSign.

Your webhook endpoint must respond within 10 seconds with an HTTP status code of 200 OK. Failing to meet this timeframe is considered unsuccessful, triggering retries.

To ensure a timely response within 10 seconds:

• Immediately acknowledge webhook requests (HTTP 200 OK).
• Handle complex operations asynchronously or in a separate thread/task after acknowledging.

If a webhook endpoint fails or doesn't respond promptly, BoldSign automatically retries delivering the event. The retry mechanism follows an exponential backoff pattern:

If all attempts fail, the webhook enters the auto-disable process.

If your webhook continuously fails (after the 6th retry), BoldSign monitors its health for 7 days. If consistent failures persist, the webhook is marked for disabling.

BoldSign provides email notifications throughout the webhook lifecycle, including:

• Initial notification of scheduled disablement.
• A reminder 24 hours before disablement.
• Notification of webhook recovery or final disablement.

If a disabled webhook endpoint starts successfully responding again within the 7-day recovery period, it is automatically reactivated.

You can manually reactivate auto-disabled webhooks via the BoldSign webhook dashboard:

1. Navigate to Settings → Webhooks.
2. Select the disabled webhook.
3. Click on Re-enable.

In certain scenarios, your endpoint may receive the same webhook event multiple times due to retries or manual resends. Ensure your webhook handler properly manages this by:

• Using the unique event ID provided in each webhook payload.
• Storing processed event IDs and ignoring any duplicate events already processed.

To test endpoint reliability or troubleshoot, you can manually resend webhook events:

• Navigate to Webhook History.
• Identify and resend the specific event.
• Once resent and successful, it will be clearly marked as successful in your webhook history dashboard.

Administrators can enable Admin Mode to receive webhook notifications for events occurring across their entire organization or team. This option is useful for integrations with automation platforms like Zapier or Power Automate.

Enable Admin Mode when creating or editing a webhook by checking the corresponding box labeled "Admin Mode."