Register New Webhook
This endpoint allows you to register a new Webhook to subscribe to certain kind of events being triggered by Squake
Important: This endpoint returns a newly created webhook upon a successful request.
The webhook includes a signing_key
used to verify the authenticity of future webhook messages.
Please ensure you save this signing_key
, as it cannot be retrieved later.
Body
This endpoint accepts JSON object with two fields:
kind
endpoint_url
Right now we're supporting next types:
order
- we'll send you an event when purchase which was made via stripe changes statusconfirmation_document_available
- we'll send a document when it's generatedcertificate_document_available
- we'll send a document when it's generated
The endpoint_url
value should be a valid URL that accepts POST
requests.
-
kind
string Values are
order
,confirmation_document_available
, orcertificate_document_available
. -
endpoint_url
string
POST
/v2/webhooks
curl \
--request POST 'https://api.squake.earth/v2/webhooks' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{"kind":"order","endpoint_url":"string"}'
Request examples
{
"kind": "order",
"endpoint_url": "string"
}
Response examples (201)
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"kind": "order",
"signing_key": "TAWHPBAVckH8KmxRtlRX/rQ/mona5vUem7QFtozGHxM=",
"endpoint_url": "http://example.com",
"last_sent_at": "2024-08-24T14:15:22Z",
"last_failed_at": "2024-08-22T14:10:78Z",
"failed_attempts": 0
}
Response examples (422)
[
{
"code": "field_validation_error",
"detail": "string",
"source": {
"id": "string",
"attribute": "string",
"model": "string"
}
}
]