{
"id": "msg_2Zx9c1",
"type": "response.analyzed",
"createdAt": "2026-09-30T10:00:07.300Z",
"data": {
"id": "9b1c2d3e-4f50-4a61-8b72-93a4b5c6d7e8",
"url": "https://app.usertick.com/inbox/9b1c2d3e-4f50-4a61-8b72-93a4b5c6d7e8",
"survey": {
"id": "11111111-1111-4111-8111-111111111111",
"name": "Checkout feedback"
},
"site": {
"id": "22222222-2222-4222-8222-222222222222",
"domain": "shop.example.com"
},
"createdAt": "2026-09-30T10:00:00.123Z",
"updatedAt": "2026-09-30T12:31:05.120Z",
"source": "widget",
"language": "en",
"country": "US",
"pageUrl": "https://shop.example.com/checkout",
"device": {
"type": "desktop",
"browser": "Chrome",
"os": "macOS"
},
"variant": null,
"variantName": null,
"contact": {
"id": "77777777-7777-4777-8777-777777777777",
"email": "[email protected]"
},
"respondent": {
"userId": "user_8271",
"anonymousId": "5f0c7a2b-8d4e-4c1a-9e3f-2b6d8a0c4e1f",
"verified": true,
"email": "[email protected]",
"emailSource": "identify",
"name": "Maya Chen",
"company": "Example Inc.",
"traits": {
"company": "Example Inc.",
"plan": "pro"
},
"traitsVerified": false,
"contactQuestion": null,
"contact": {
"id": "77777777-7777-4777-8777-777777777777"
}
},
"answers": [
{
"questionId": "q_nps",
"question": "How likely are you to recommend us?",
"type": "nps",
"value": 4,
"text": "4"
},
{
"questionId": "q_comment",
"question": "What went wrong?",
"type": "text",
"value": "Checkout rejects my card every time",
"text": "Checkout rejects my card every time"
}
],
"answerText": {
"q_nps": "4",
"q_comment": "Checkout rejects my card every time"
},
"attachments": [],
"status": "in_progress",
"assignees": [
{
"id": "66666666-6666-4666-8666-666666666666",
"name": "Ana Ruiz",
"email": "[email protected]"
}
],
"ai": {
"type": "bug",
"urgency": "high",
"theme": {
"id": "44444444-4444-4444-8444-444444444444",
"name": "Checkout errors"
},
"category": {
"id": "55555555-5555-4555-8555-555555555555",
"name": "Payments"
},
"sentiment": "negative",
"analyzedAt": "2026-09-30T10:00:07.250Z",
"corrected": false
},
"commentsCount": 2
}
}Webhook events
response.created
A response was submitted. data.ai is always null. Answer 2xx within 30 seconds. A failed delivery is retried with backoff (30 s, 2 min, 10 min, 1 h, 6 h); a subscription answered 410 Gone ends.
WEBHOOK
response.created
{
"id": "msg_2Zx9c1",
"type": "response.analyzed",
"createdAt": "2026-09-30T10:00:07.300Z",
"data": {
"id": "9b1c2d3e-4f50-4a61-8b72-93a4b5c6d7e8",
"url": "https://app.usertick.com/inbox/9b1c2d3e-4f50-4a61-8b72-93a4b5c6d7e8",
"survey": {
"id": "11111111-1111-4111-8111-111111111111",
"name": "Checkout feedback"
},
"site": {
"id": "22222222-2222-4222-8222-222222222222",
"domain": "shop.example.com"
},
"createdAt": "2026-09-30T10:00:00.123Z",
"updatedAt": "2026-09-30T12:31:05.120Z",
"source": "widget",
"language": "en",
"country": "US",
"pageUrl": "https://shop.example.com/checkout",
"device": {
"type": "desktop",
"browser": "Chrome",
"os": "macOS"
},
"variant": null,
"variantName": null,
"contact": {
"id": "77777777-7777-4777-8777-777777777777",
"email": "[email protected]"
},
"respondent": {
"userId": "user_8271",
"anonymousId": "5f0c7a2b-8d4e-4c1a-9e3f-2b6d8a0c4e1f",
"verified": true,
"email": "[email protected]",
"emailSource": "identify",
"name": "Maya Chen",
"company": "Example Inc.",
"traits": {
"company": "Example Inc.",
"plan": "pro"
},
"traitsVerified": false,
"contactQuestion": null,
"contact": {
"id": "77777777-7777-4777-8777-777777777777"
}
},
"answers": [
{
"questionId": "q_nps",
"question": "How likely are you to recommend us?",
"type": "nps",
"value": 4,
"text": "4"
},
{
"questionId": "q_comment",
"question": "What went wrong?",
"type": "text",
"value": "Checkout rejects my card every time",
"text": "Checkout rejects my card every time"
}
],
"answerText": {
"q_nps": "4",
"q_comment": "Checkout rejects my card every time"
},
"attachments": [],
"status": "in_progress",
"assignees": [
{
"id": "66666666-6666-4666-8666-666666666666",
"name": "Ana Ruiz",
"email": "[email protected]"
}
],
"ai": {
"type": "bug",
"urgency": "high",
"theme": {
"id": "44444444-4444-4444-8444-444444444444",
"name": "Checkout errors"
},
"category": {
"id": "55555555-5555-4555-8555-555555555555",
"name": "Payments"
},
"sentiment": "negative",
"analyzedAt": "2026-09-30T10:00:07.250Z",
"corrected": false
},
"commentsCount": 2
}
}Authorizations
bearerAuthapiKeyHeader
An API key (utk_live_...) or an app's OAuth access token (uto_...).
Headers
The message id (the body's id); the same on every retry and resend.
Unix seconds when this attempt was signed.
Standard Webhooks: v1, then the base64 HMAC-SHA256 of "{webhook-id}.{webhook-timestamp}.{body}" with the whsec_ secret (decoded). During a secret rotation two signatures, space separated.
The event, as in the body's type.
1 for the first try; retries count up.
Body
application/json
The body of every webhook delivery that carries a response.
The message id: the same value as the webhook-id header, kept on every retry and resend.
Available options:
response.created, response.analyzed, response.urgent When the event happened.
Example:
"2026-09-30T10:00:00.000Z"
One response: what every response read returns and what every webhook delivery carries in data.
Show child attributes
Show child attributes
Example:
{
"id": "9b1c2d3e-4f50-4a61-8b72-93a4b5c6d7e8",
"url": "https://app.usertick.com/inbox/9b1c2d3e-4f50-4a61-8b72-93a4b5c6d7e8",
"survey": {
"id": "11111111-1111-4111-8111-111111111111",
"name": "Checkout feedback"
},
"site": {
"id": "22222222-2222-4222-8222-222222222222",
"domain": "shop.example.com"
},
"createdAt": "2026-09-30T10:00:00.123Z",
"updatedAt": "2026-09-30T12:31:05.120Z",
"source": "widget",
"language": "en",
"country": "US",
"pageUrl": "https://shop.example.com/checkout",
"device": {
"type": "desktop",
"browser": "Chrome",
"os": "macOS"
},
"variant": null,
"variantName": null,
"contact": {
"id": "77777777-7777-4777-8777-777777777777",
"email": "[email protected]"
},
"respondent": {
"userId": "user_8271",
"anonymousId": "5f0c7a2b-8d4e-4c1a-9e3f-2b6d8a0c4e1f",
"verified": true,
"email": "[email protected]",
"emailSource": "identify",
"name": "Maya Chen",
"company": "Example Inc.",
"traits": { "company": "Example Inc.", "plan": "pro" },
"traitsVerified": false,
"contactQuestion": null,
"contact": {
"id": "77777777-7777-4777-8777-777777777777"
}
},
"answers": [
{
"questionId": "q_nps",
"question": "How likely are you to recommend us?",
"type": "nps",
"value": 4,
"text": "4"
},
{
"questionId": "q_comment",
"question": "What went wrong?",
"type": "text",
"value": "Checkout rejects my card every time",
"text": "Checkout rejects my card every time"
}
],
"answerText": {
"q_nps": "4",
"q_comment": "Checkout rejects my card every time"
},
"attachments": [],
"status": "in_progress",
"assignees": [
{
"id": "66666666-6666-4666-8666-666666666666",
"name": "Ana Ruiz",
"email": "[email protected]"
}
],
"ai": {
"type": "bug",
"urgency": "high",
"theme": {
"id": "44444444-4444-4444-8444-444444444444",
"name": "Checkout errors"
},
"category": {
"id": "55555555-5555-4555-8555-555555555555",
"name": "Payments"
},
"sentiment": "negative",
"analyzedAt": "2026-09-30T10:00:07.250Z",
"corrected": false
},
"commentsCount": 2
}
Response
2XX
Received.