Get Webhook

Retrieve a single webhook subscription and its recent delivery logs.

cURL

curl -X GET https://api.dronebundle.com/v1/webhooks/019d5221-b413-71a9-a56b-f70bc91efe63 \
  -H "Authorization: Bearer v1_your_api_key_here"

200

{
  "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": "[e-mail]",
      "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

webhookId · string · required

The unique identifier of the webhook.

Query parameters

cursor · string

Pagination cursor for delivery logs. Omit for the first page.

Response

webhook · object

Show webhook object

id · string

Webhook ID.

name · string

Webhook name.

url · string

The HTTPS endpoint that receives webhook deliveries.

event_types · string[]

List of event types this webhook is subscribed to.

status · string

Webhook status. Either active or paused.

failure_count · number

Number of consecutive delivery failures.

created · number

Unix timestamp (milliseconds) when the webhook was created.

updated · number

Unix timestamp (milliseconds) when the webhook was last updated.

created_by · object | null

The user or API key that created the webhook.

Show properties

id · string

User ID or API key ID.

email · string | null

User email. null for API key-created webhooks.

first_name · string | null

First name, or API key name for API key-created webhooks.

last_name · string | null

Last name. null for API key-created webhooks.

last_triggered_at · number | null

Unix timestamp (milliseconds) of the last delivery attempt.

logs · object[]

Recent delivery log entries, sorted newest first.

Show log object

id · string

Delivery log ID.

event_type · string

The event type that triggered this delivery.

url · string

The URL the delivery was sent to.

status · string

Delivery status. Either success or failed.

response_status · number | null

HTTP response status code from the target, or null if the request failed.

response_body · string | null

First 1024 characters of the response body.

request_payload · string | null

The JSON payload that was sent.

duration_ms · number

Delivery duration in milliseconds.

error_message · string | null

Error message if the delivery failed.

created · number

Unix timestamp (milliseconds) when the delivery was attempted.

log_count · number

Number of delivery logs in the current page.

cursor · string | null

Cursor for the next page of logs. null when there are no more results.

cURL

curl -X GET https://api.dronebundle.com/v1/webhooks/019d5221-b413-71a9-a56b-f70bc91efe63 \
  -H "Authorization: Bearer v1_your_api_key_here"

200

{
  "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": "[e-mail]",
      "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"
}