Back to Documentation

Webhooks

Receive real-time notifications when events occur

What are Webhooks?

Webhooks send HTTP POST requests to your server when events happen in ServiceCrew AI. Use them to sync data, trigger automations, or notify external systems in real-time.

Available Events

job.createdNew job created
job.updatedJob details changed
job.completedJob marked complete
invoice.createdNew invoice generated
invoice.paidPayment received
customer.createdNew customer added

Setting Up Webhooks

1

Go to Settings → Webhooks

2

Click "Add Endpoint"

3

Enter your endpoint URL

4

Select events to subscribe to

5

Save and test

Webhook Payload

Each webhook includes event type, timestamp, and relevant data in JSON format:

{
  "event": "job.completed",
  "timestamp": "2025-01-15T14:30:00Z",
  "data": {
    "job_id": "job_123abc",
    "customer_id": "cust_456def",
    "status": "completed",
    ...
  }
}

Retry Policy

Automatic Retries

Failed webhooks are retried up to 5 times with exponential backoff. If your endpoint returns a non-2xx status code, we'll retry the delivery.

Verification

Verify webhook authenticity using the signature header:

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

Pro Tip

Use webhook logs in Settings → Webhooks to debug delivery issues. You can see the request payload, response status, and retry attempts.