Skip to main content

Overview

Revenueable AI’s event-based webhook system allows you to subscribe to specific events for your AI agents and receive real-time callbacks when those events occur. This eliminates the need to continuously poll our API for updates.

Event Types

Our webhook system supports four main event types. You can subscribe to any or all of these events based on your needs:

Configuration

To subscribe an agent to webhook events, use this PATCH request:

Subscription Flexibility

You have complete flexibility in choosing which events to subscribe to:

Subscribe to Only Call Completion

Subscribe to Analysis Events Only

Requirements

Webhook Endpoint

Provide the full HTTPS URL where webhook notifications should be sent.

Authentication

Configure custom headers for secure webhook delivery. Common patterns:
  • Authorization: Bearer your-webhook-token
  • Custom API keys in headers
  • Additional security headers as needed

HTTP Methods

Supported methods:
  • POST (recommended)
  • PUT
  • PATCH

Response Requirements

Your endpoint must:
  • Return HTTP 200 status code to acknowledge receipt
  • Respond within 30 seconds to avoid timeout
  • Handle duplicate events using call_id for idempotency