curl https://api.fastdrop.io/api/v1/webhooks \
-H "X-API-Key: fd_live_your_key_here"
{
"webhooks": [
{
"id": "3f9a1c22-8e4b-4d7a-9c11-77d2f0b5a8e3",
"url": "https://your-server.com/webhooks/fastdrop",
"events": ["job.completed", "job.failed"],
"description": "Production webhook",
"secret_prefix": "a1b2c3d4",
"payload_version": "v1",
"is_active": true,
"created_at": "2026-08-15T12:00:00Z"
}
]
}
Webhooks
List Webhooks
List all registered webhook endpoints
GET
/
webhooks
curl https://api.fastdrop.io/api/v1/webhooks \
-H "X-API-Key: fd_live_your_key_here"
{
"webhooks": [
{
"id": "3f9a1c22-8e4b-4d7a-9c11-77d2f0b5a8e3",
"url": "https://your-server.com/webhooks/fastdrop",
"events": ["job.completed", "job.failed"],
"description": "Production webhook",
"secret_prefix": "a1b2c3d4",
"payload_version": "v1",
"is_active": true,
"created_at": "2026-08-15T12:00:00Z"
}
]
}
Returns all webhook endpoints for your API key, newest first.
Response (200 OK)
object[]
Array of registered webhook endpoints.
Show properties
Show properties
string
Endpoint UUID.
string
Destination URL.
string[]
Subscribed event types.
string | null
Your label for the endpoint.
string
First 8 characters of the signing secret — enough to identify which secret an
endpoint uses, useless as a key. The full secret is returned only by
Register Webhook and
Rotate Secret.Before 2026-08-15 this field was the full secret. If you stored a response
from that period, see FD-2026-001.
string
v1 for the documented envelope, legacy for the flat payload sent to
endpoints registered before 2026-08-15. See Webhooks.boolean
Whether deliveries are attempted.
string
ISO 8601 timestamp.
curl https://api.fastdrop.io/api/v1/webhooks \
-H "X-API-Key: fd_live_your_key_here"
{
"webhooks": [
{
"id": "3f9a1c22-8e4b-4d7a-9c11-77d2f0b5a8e3",
"url": "https://your-server.com/webhooks/fastdrop",
"events": ["job.completed", "job.failed"],
"description": "Production webhook",
"secret_prefix": "a1b2c3d4",
"payload_version": "v1",
"is_active": true,
"created_at": "2026-08-15T12:00:00Z"
}
]
}