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

# Webhooks

> Receive real-time event notifications

## Overview

Webhooks send real-time HTTP notifications when events occur in your Graine AI account.

## Supported Events

* Call started
* Call ended
* Call failed
* Transcript updated
* Campaign progress
* Agent status changes

## Configuration

<Steps>
  <Step title="Get Webhook URL">
    Set up an endpoint to receive webhook notifications
  </Step>

  <Step title="Configure in Platform">
    Add your webhook URL in agent or campaign settings
  </Step>

  <Step title="Verify Signature">
    Implement signature verification for security
  </Step>

  <Step title="Handle Events">
    Process incoming webhook payloads
  </Step>
</Steps>

## Webhook Platforms

<CardGroup cols={3}>
  <Card title="Make" icon="arrows-split-up-and-left">
    Integromat workflows
  </Card>

  <Card title="n8n" icon="diagram-project">
    Workflow automation
  </Card>

  <Card title="Custom" icon="code">
    Your own server
  </Card>
</CardGroup>

## Payload Example

```json theme={null}
{
  "event": "call.ended",
  "call_id": "call_123",
  "agent_id": "agent_456",
  "status": "completed",
  "duration": 180,
  "transcript": "..."
}
```

## Best Practices

* Implement retry logic
* Verify webhook signatures
* Respond with 200 OK quickly
* Process data asynchronously
* Log all webhook events

## Next Steps

<Card title="API Documentation" icon="code" href="/integrations/api">
  Explore the full API
</Card>