Test Webhook

Send a test payload to verify your webhook endpoint

POSThttps://app.ranked.ai/api/v1/webhooks/{webhookId}/test

Sends a test payload to the webhook URL to verify connectivity and signature verification.

webhookIdstringrequired

Webhook subscription UUID

Request

curl -X POST "https://app.ranked.ai/api/v1/webhooks/{webhookId}/test" \
  -H "Authorization: Bearer rk_live_your_api_key"

Response

{
  "success": true,
  "data": {
    "success": true,
    "message": "Test webhook delivered successfully",
    "status_code": 200
  }
}

The test payload sent to your URL looks like:

JSON

{
  "event": "content.created",
  "timestamp": "2026-05-16T01:06:30.000Z",
  "project_id": "test-project-id",
  "data": {
    "test": true,
    "message": "This is a test webhook from Ranked AI"
  }
}

It includes the same X-Webhook-Signature header as real deliveries, signed with your subscription's secret.

This page is also available as markdown for AI agents, and the whole reference as an OpenAPI spec. Questions? Developer support.