Webhook Configuration

Webhooks allow you to receive real-time notifications when events occur in your workspace.

What Are Webhooks?

Webhooks send HTTP POST requests to your specified URL when:

A project is created or updated
A task status changes
A file is uploaded
A team member is added
Custom events you define

Creating a Webhook

Go to Settings → Integrations → Webhooks
Click "Create Webhook"
Enter your endpoint URL
Select events to monitor
Add a secret key for verification
Click "Save"

Webhook Payload

Each webhook includes:

{
  "event": "project.created",
  "timestamp": "2025-11-10T12:00:00Z",
  "data": {
    "id": "12345",
    "name": "New Project",
    "created_by": "user@example.com"
  }
}

Verifying Webhooks

Verify authenticity using the signature header:

X-Webhook-Signature: sha256=abc123...

Compare this with HMAC-SHA256 hash of the payload using your secret key.

Retry Logic

If your endpoint fails:

We retry 3 times with exponential backoff
1st retry: after 1 minute
2nd retry: after 5 minutes
3rd retry: after 15 minutes

Testing

Test your webhook:

Click "Test Webhook" in settings
Check your endpoint receives the test payload
Verify response is 200 OK

Best Practices

Always verify signatures
Respond with 200 OK quickly
Process data asynchronously
Handle idempotency
Log all webhook events

Setting Up Webhooks