Webhook Endpoint | Gradii API Documentation

curl -X POST https://gradii.ai/api/v2/webhooks/iris \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "event": "call_ended",
  "call": {
    "call_id": "retell_call_123",
    "from_number": "+1234567890",
    "to_number": "+1987654321",
    "direction": "outbound",
    "agent_id": "retell_agent_456",
    "call_status": "ended",
    "duration": 420,
    "transcript": "Full conversation transcript...",
    "call_analysis": {
      "sentiment": "positive",
      "topics": [
        "experience",
        "skills"
      ],
      "summary": "Candidate showed strong technical skills..."
    },
    "recording_url": "https://recordings.retell.ai/call_123.mp3"
  },
  "timestamp": "2024-01-28T14:30:00Z"
}'

Webhook endpoint to receive Retell AI call status updates and results. This is called automatically by the system.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

eventstringRequired

Event type: call_started, call_ended, call_analyzed

callobjectRequired

timestampstringOptional

ISO datetime string

Response

Webhook processed successfully

successbooleanOptional

eventstringOptional

callIdstringOptional

messagestringOptional

timestampstringOptional

1	{
2	"success": true,
3	"event": "call_ended",
4	"callId": "retell_call_123",
5	"message": "Webhook processed successfully",
6	"timestamp": "2024-01-28T14:30:00Z"
7	}