> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replyify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks Guide

> Set up outgoing webhooks for real-time notifications

Outgoing webhooks let you receive real-time HTTP notifications when events happen in Replyify. Use them to sync data with your CRM, trigger automations, or build custom integrations.

## Setting Up Webhooks

1. Go to **Settings > Webhooks** in your dashboard
2. Click **Add Webhook**
3. Enter a name, your endpoint URL, and optionally a signing secret
4. Select which events you want to receive
5. Click **Create Webhook**

## Testing Your Endpoint

Use the **Test** button next to any webhook to send a sample payload. This verifies your endpoint is reachable and responding correctly.

## Payload Structure

All events follow the same structure:

```json theme={null}
{
  "event": "reply.received",
  "timestamp": "2025-01-27T12:00:00Z",
  "workspace_id": "uuid",
  "data": {
    // Event-specific fields
  }
}
```

See the [Events reference](/api-reference/webhooks/events) for details on each event type.

## Verifying Signatures

If you set a signing secret, verify the `X-Replyify-Signature` header using HMAC-SHA256:

```python theme={null}
import hmac
import hashlib
import json

def verify_webhook(payload, signature, secret):
    expected = hmac.new(
        secret.encode(),
        json.dumps(payload).encode(),
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(signature, expected)
```

See the [Security reference](/api-reference/webhooks/security) for more details and examples in other languages.

## Retry Policy

Failed deliveries (non-2xx response or timeout) are retried up to **3 times** with exponential backoff. You can monitor delivery status in the **Recent Deliveries** section of each webhook.

## Use Cases

* **CRM Sync** — Push new interested leads to your CRM when `reply.received` fires
* **Slack Notifications** — Alert your team when positive replies come in
* **Analytics Pipeline** — Stream reply data to your analytics warehouse
* **Custom Workflows** — Trigger Zapier/Make automations on any event