API Documentation

Quick Start

Get your first webhook flowing in under 2 minutes:

1. Sign up for a free account
2. Create an endpoint in the dashboard
3. Send a webhook to your unique URL
4. Watch it get delivered to your endpoint

Sending Webhooks

Send webhooks to your unique wheneva.ai URL:

POST https://wheneva.ai/webhooks/{provider}/{account_slug}

# Example: Send an OpenAI completion event
curl -X POST https://wheneva.ai/webhooks/openai/your-slug \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4",
    "choices": [{
      "message": { "content": "Hello!" }
    }]
  }'

Supported providers: openai, anthropic, google, custom

API Endpoints

All API requests require a Bearer token. Get yours from the dashboard.

GET /api/v1/endpoints

List all your configured endpoints.

POST /api/v1/endpoints

Create a new endpoint to receive webhooks.

GET /api/v1/webhook_events

List received webhook events with filtering.

GET /api/v1/deliveries

List webhook deliveries and their statuses.

GET /api/v1/analytics/deliveries

Get delivery analytics — success rates, error patterns, per-endpoint stats.

GET /api/v1/analytics/performance

Get performance metrics — response times, throughput, latency.

GET /api/v1/usage

Check your current usage against plan limits.

Transformations

Transform webhook payloads before delivery:

• Field mapping — rename and remap payload fields
• Payload restructuring — reshape nested JSON structures
• Conditional routing — route based on payload content
• Multi-destination — fan out to multiple endpoints

Configure transformations per-endpoint in the dashboard, or via the API:

POST /api/v1/transformations

{
  "transformation": {
    "name": "Extract completion text",
    "transformation_type": "field_mapping",
    "config": {
      "mappings": [
        { "from": "choices.0.message.content", "to": "text" }
      ]
    }
  }
}

Need Help?

Questions? Reach out at [email protected]