Webhooks

Get a webhook

One webhook, with its delivery status.

GET

/api/v1/webhooks/{webhookId}

Path parameters

webhookId

required

string · uuid

Webhook id

Response

200The webhook.

webhook

object

id

string · uuid

url

string

headerNames

string[]

Names of the extra headers sent with every request.

lastAttemptAt

string · date-time | null

lastError

string | null

Why the last failed delivery failed, for example 401. Null once a delivery succeeds.

createdAt

string · date-time

createdBy

string · uuid

The member who created the webhook. It receives the events they can see, and is deleted when they leave the workspace.

requestId

string · uuid

Id of this request, for support and troubleshooting

Errors

  • 400: Bad request
  • 401: Unauthorized: missing or invalid API key
  • 403: Forbidden
  • 404: Not found
  • 422: Invalid request payload

Search docs

Search documentation, API reference, and MCP tools

We use cookies to enhance your experience on Needle and keep your data secure. Privacy Policy