Fictional API example. This page demonstrates documentation features; its operations do not describe a live service.
This webhook reference is generated from the OpenAPI description. The provider sends this event to the receiver.
OpenAPI for this operation: Download JSON.
Webhook: parcel.delivered
The provider sends a POST request for this event to the receiver's webhook URL.
Parcel delivered event
The service sends this event to the receiver's webhook URL.
Authentication
Use one of these authentication options:
Bearer token
HTTP bearer (JWT).
Short-lived service token.
API key
API key in header X-Parcel-Key.
Long-lived account key.
Request body
Required.
application/json
5 properties
-
eventIdstringrequired ⓘ -
parcelIdstringrequired ⓘ -
occurredAtstringrequired ⓘformat: date-time
-
outcomeenum<string>required ⓘ -
proofone of several typesrequired ⓘUse exactly one of these shapes:
Photo proof · 2 properties
object
2 properties
-
kindstringrequired ⓘconst: "photo"
-
urlstringrequired ⓘformat: uri
Signature proof · 2 properties
object
2 properties
-
kindstringrequired ⓘconst: "signature"
-
signedBystringrequired ⓘ
-
Responses
204: No Content
Receiver accepted the event.