APIWebhook events
customer_need.created
A thread was linked to an issue or project.
Headers
Productlane-EventstringrequiredThe event type.
Productlane-Event-IdstringrequiredUnique per event. Use it to drop duplicates.
Productlane-Delivery-IdstringrequiredUnique per delivery attempt.
Productlane-Webhook-IdstringrequiredThe webhook subscription that matched.
Productlane-SignaturestringrequiredHMAC-SHA256 of the raw body, as t=<timestamp>,v1=<signature>.
Body
application/json
idstringrequiredSame as the Productlane-Event-Id header.
typeenum<string>requiredOne of:customer_need.createdcreated_atstring<date-time>requireddataany ofrequired
Example payload
{
"id": "string",
"type": "customer_need.created",
"created_at": "2026-01-15T09:30:00Z",
"data": {
"id": "string",
"thread_id": "string",
"project_id": "string",
"issue_id": "string",
"priority": 0,
"created_at": "string",
"updated_at": "string"
}
}Your response
200
Return any 2xx status to acknowledge the event. Anything else counts as a failure: we try 3 times in total, right away and then after 1 and 5 minutes.