Getting Started

Webhooks

Webhooks let you receive real-time HTTP notifications when events occur in your account.

Registering a webhook

POST /v1/webhooks
{
  "url": "https://your-server.com/hook",
  "events": ["project.created", "invoice.paid", "api_key.revoked"],
  "secret": "your_signing_secret"
}

Verifying the signature

# Python example
import hmac, hashlib

def verify(payload, signature, secret):
    expected = hmac.new(secret.encode(), payload, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature)

Event types

Event	Trigger
`project.created`	A new project is created
`project.deleted`	A project is deleted
`invoice.paid`	An invoice is paid
`api_key.revoked`	An API key is revoked
`user.invited`	A team member is invited

← Previous Rate Limits Next → API Changelog

Was this article helpful?