Needle LogoNeedle

Webhooks

Change a webhook URL

The secret stays the same. Pending deliveries go to the new URL.

PATCH

/api/v1/webhooks/{webhookId}

Path parameters

webhookId

required

string · uuid

Webhook id

Request bodyrequired

urlrequired

string · uri

An https URL that accepts POST requests.

Response

200Webhook updated.

webhook

object

id

string · uuid

url

string

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 | null

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