API referenceWebhooks
List deliveries
GET
/api/v2/webhooks/{id}/deliveriesRecent delivery attempts, newest first. Needs webhooks:read.
id*stringId of a webhook: webhook_ followed by its key.
Match
^webhook_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$limit?stringPage size, 1 to 100. Default 20.
cursor?stringThe nextCursor of the previous page. Opaque: never build or decode it.
Success
application/json- response
object*"list"Type of the object. Always list.
Value in
"list"data*array<>The items on this page.
hasMore*booleanWhether another page follows.
nextCursor*|Opaque cursor for the next page. Pass it back as ?cursor=. null on the last page.
curl -X GET 'https://www.talentir.com/api/v2/webhooks/webhook_0e4ba886-0bfe-4b6a-ae2e-d6d9d135dd1e/deliveries'Example Response
{ "object": "list", "data": [ { "object": "delivery", "id": "delivery_0e4ba886-0bfe-4b6a-ae2e-d6d9d135dd1e", "eventId": "event_0e4ba886-0bfe-4b6a-ae2e-d6d9d135dd1e", "eventType": "string", "status": "delivered", "responseStatus": -9007199254740991, "attempt": -9007199254740991, "nextRetryAt": "2026-09-24T10:00:00.000Z", "createdAt": "2026-09-24T10:00:00.000Z", "updatedAt": "2026-09-24T10:00:00.000Z" } ], "hasMore": true, "nextCursor": "string"}Send a test event POST
Sends a `webhook.ping` event, with the webhook as `data`, and returns the delivery. Needs `webhooks:write`.
Create a session POST
Mints a signed Talentir URL for a hosted screen. `type` selects the screen and its audience. A session has no `GET`; the id is embedded in the URL. Needs `sessions:write`.