Webhooks
Webhooks notify external systems when flag changes occur. Use them to trigger CI/CD pipelines, send Slack notifications, or sync with other tools.
Configure webhooks in Settings → Webhooks →
Event Types
| Event | When |
|---|---|
flag.created | A new flag is created |
flag.updated | Flag metadata is updated |
flag.deleted | A flag is deleted |
flag.killed | Kill switch activated |
flag.promoted | Flag promoted between environments |
* | All events |
Payload Format
json
{
"type": "flag.updated",
"flag_id": "uuid",
"env_id": "uuid",
"timestamp": "2026-04-01T12:00:00Z"
}Signature Verification
python
import hmac, hashlib
def verify_signature(payload: bytes, signature: str, secret: str) -> bool:
expected = hmac.new(secret.encode(), payload, hashlib.sha256).hexdigest()
return hmac.compare_digest(f"sha256={expected}", signature)