Paigo · Schema
CreateWebhookDto
BillingUsage-Based BillingMeteringInvoicingPricingSoftware-as-a-ServiceSubscriptionDeveloper ToolsFinOps
Properties
| Name | Type | Description |
|---|---|---|
| hookUrl | string | The URL Paigo will callback to when the webhook type event occurs. Example: `"https://example.com/webhook"` |
| securityKey | string | 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. Example: `"1234567890"` |
| environment | string | The environment the webhook is for. This is used to differentiate between sandbox and production. Optional, will default to `production` if not provided. Example: `"sandbox"` |
| webhookType | string | The type of webhook event to listen for. This will determine when the webhook is triggered. Example: `"INVOICE_CREATED"` |
| offeringId | string | The offering the webhook is for. This is used to differentiate between different offerings. Only used for `ENTITLEMENT` webhooks. Example: `"539b7f74-3832-474e-a955-6d69c5df12d0"` |
JSON Schema
{
"$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<br/><br/>\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<br/><br/>\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<br/><br/>\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<br/><br/>\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<br/><br/>\nExample: `\"539b7f74-3832-474e-a955-6d69c5df12d0\"`",
"example": "539b7f74-3832-474e-a955-6d69c5df12d0"
}
},
"required": [
"hookUrl",
"webhookType"
]
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/paigo-create-webhook"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.