Webhooks
Add an https URL that receives events, signed with a new secret. eventTypes picks the event types: "all" (the default, also types added later) or a list. The whsec_ secret is returned only here; show it to the user so they can store it. Up to 5 per workspace. Optional headers, such as an API key the URL requires, are sent with every request. Header values you send pass through your AI app.
| urlrequired | string · uri An https URL that accepts POST requests. |
| headersoptional | object Extra headers sent with every request, for example an API key your endpoint checks: {"Authorization": "Bearer ..."}. Up to 5. Names are stored in lower case. |
| eventTypesoptional | string | string[] The event types this webhook gets: "all" (every type, also types added later) or a list. Left out, it is "all". |
Search documentation, API reference, and MCP tools
We use cookies to enhance your experience on Needle and keep your data secure. Privacy Policy
