{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://paigo.tech/json-schema/CreateWebhookDto.json",
"title": "CreateWebhookDto",
"type": "object",
"properties": {
"hookUrl": {
"type": "string",
"description": "The URL Paigo will callback to when the webhook type event occurs.\n
\nExample: `\"https://example.com/webhook\"`",
"example": "https://example.com/webhook"
},
"securityKey": {
"type": "string",
"description": "The security key used to authenticate the webhook. This is used to ensure the webhook is coming from Paigo. The key will be sent in the `X-Paigo-Security` header.\n
\nExample: `\"1234567890\"`",
"example": "1234567890"
},
"environment": {
"type": "string",
"description": "The environment the webhook is for. This is used to differentiate between sandbox and production. Optional, will default to `production` if not provided.\n
\nExample: `\"sandbox\"`",
"example": "sandbox"
},
"webhookType": {
"type": "string",
"description": "The type of webhook event to listen for. This will determine when the webhook is triggered.\n
\nExample: `\"INVOICE_CREATED\"`",
"example": "INVOICE_CREATED",
"enum": [
"INVOICE_CREATED",
"INVOICE_PAID",
"STRIPE_PAYMENT_FAILED",
"CUSTOMER_CREATED",
"CUSTOMER_UPDATED",
"ENTITLEMENT",
"INVOICE_SENT"
]
},
"offeringId": {
"type": "string",
"description": "The offering the webhook is for. This is used to differentiate between different offerings. Only used for `ENTITLEMENT` webhooks.\n
\nExample: `\"539b7f74-3832-474e-a955-6d69c5df12d0\"`",
"example": "539b7f74-3832-474e-a955-6d69c5df12d0"
}
},
"required": [
"hookUrl",
"webhookType"
]
}