Webhooks
Get Webhook
Retrieve a single webhook subscription and its recent delivery logs.
curl -X GET https://api.dronebundle.com/v1/webhooks/019d5221-b413-71a9-a56b-f70bc91efe63 \
-H "Authorization: Bearer v1_your_api_key_here"
{
"webhook": {
"id": "019d5221-b413-71a9-a56b-f70bc91efe63",
"name": "Project notifications",
"url": "https://hooks.example.com/dronebundle",
"event_types": ["project.created", "project.updated"],
"status": "active",
"failure_count": 0,
"created": 1743400000000,
"updated": 1743400000000,
"created_by": {
"id": "user-abc-123",
"email": "sarah@example.com",
"first_name": "Sarah",
"last_name": "Chen"
},
"last_triggered_at": 1743500000000
},
"logs": [
{
"id": "019d5300-a1b2-7000-8000-abc123def456",
"event_type": "project.created",
"url": "https://hooks.example.com/dronebundle",
"status": "success",
"response_status": 200,
"response_body": "{\"ok\":true}",
"request_payload": "{\"delivery_id\":\"...\",\"event\":\"project.created\",\"timestamp\":1743500000000,\"workspace_id\":\"...\",\"data\":{...}}",
"duration_ms": 245,
"error_message": null,
"created": 1743500000000
}
],
"log_count": 1,
"cursor": null
}
Requires an API key with
read_only or full_access scope.
Returns the webhook details along with a paginated list of recent delivery logs.
Path parameters
string
required
The unique identifier of the webhook.
Query parameters
string
Pagination cursor for delivery logs. Omit for the first page.
Response
object
Show webhook object
Show webhook object
string
Webhook ID.
string
Webhook name.
string
The HTTPS endpoint that receives webhook deliveries.
string[]
List of event types this webhook is subscribed to.
string
Webhook status. Either
active or paused.number
Number of consecutive delivery failures.
number
Unix timestamp (milliseconds) when the webhook was created.
number
Unix timestamp (milliseconds) when the webhook was last updated.
object | null
number | null
Unix timestamp (milliseconds) of the last delivery attempt.
object[]
Recent delivery log entries, sorted newest first.
Show log object
Show log object
string
Delivery log ID.
string
The event type that triggered this delivery.
string
The URL the delivery was sent to.
string
Delivery status. Either
success or failed.number | null
HTTP response status code from the target, or
null if the request failed.string | null
First 1024 characters of the response body.
string | null
The JSON payload that was sent.
number
Delivery duration in milliseconds.
string | null
Error message if the delivery failed.
number
Unix timestamp (milliseconds) when the delivery was attempted.
number
Number of delivery logs in the current page.
string | null
Cursor for the next page of logs.
null when there are no more results.curl -X GET https://api.dronebundle.com/v1/webhooks/019d5221-b413-71a9-a56b-f70bc91efe63 \
-H "Authorization: Bearer v1_your_api_key_here"
{
"webhook": {
"id": "019d5221-b413-71a9-a56b-f70bc91efe63",
"name": "Project notifications",
"url": "https://hooks.example.com/dronebundle",
"event_types": ["project.created", "project.updated"],
"status": "active",
"failure_count": 0,
"created": 1743400000000,
"updated": 1743400000000,
"created_by": {
"id": "user-abc-123",
"email": "sarah@example.com",
"first_name": "Sarah",
"last_name": "Chen"
},
"last_triggered_at": 1743500000000
},
"logs": [
{
"id": "019d5300-a1b2-7000-8000-abc123def456",
"event_type": "project.created",
"url": "https://hooks.example.com/dronebundle",
"status": "success",
"response_status": 200,
"response_body": "{\"ok\":true}",
"request_payload": "{\"delivery_id\":\"...\",\"event\":\"project.created\",\"timestamp\":1743500000000,\"workspace_id\":\"...\",\"data\":{...}}",
"duration_ms": 245,
"error_message": null,
"created": 1743500000000
}
],
"log_count": 1,
"cursor": null
}
Errors
404 Not Found - Webhook not found.{
"message": "Webhook not found"
}
⌘I
curl -X GET https://api.dronebundle.com/v1/webhooks/019d5221-b413-71a9-a56b-f70bc91efe63 \
-H "Authorization: Bearer v1_your_api_key_here"
{
"webhook": {
"id": "019d5221-b413-71a9-a56b-f70bc91efe63",
"name": "Project notifications",
"url": "https://hooks.example.com/dronebundle",
"event_types": ["project.created", "project.updated"],
"status": "active",
"failure_count": 0,
"created": 1743400000000,
"updated": 1743400000000,
"created_by": {
"id": "user-abc-123",
"email": "sarah@example.com",
"first_name": "Sarah",
"last_name": "Chen"
},
"last_triggered_at": 1743500000000
},
"logs": [
{
"id": "019d5300-a1b2-7000-8000-abc123def456",
"event_type": "project.created",
"url": "https://hooks.example.com/dronebundle",
"status": "success",
"response_status": 200,
"response_body": "{\"ok\":true}",
"request_payload": "{\"delivery_id\":\"...\",\"event\":\"project.created\",\"timestamp\":1743500000000,\"workspace_id\":\"...\",\"data\":{...}}",
"duration_ms": 245,
"error_message": null,
"created": 1743500000000
}
],
"log_count": 1,
"cursor": null
}