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

# Call Booked Webhook

> Webhook event triggered when a call is successfully booked in iClosed.io

## Overview

The **Call Booked** webhook is triggered whenever a call is successfully scheduled and booked in your iClosed.io account. This event provides comprehensive details about the booked call, including event information, invitee details, and scheduling data.

## Event Details

* **Event Type**: `callBooked`
* **Trigger**: When a call is successfully booked through any booking channel
* **Payload**: Complete call booking information with event and invitee details

## Webhook Payload

The webhook payload contains detailed information about the booked call:

```json theme={null}
[
  {
    "event_type": {
      "uuid": "123",
      "kind": "Round Robin",
      "slug": "event-name",
      "name": "Event Name",
      "duration": "15",
      "durationUnit": "MINUTES",
      "owner": {
        "type": "closer"
      },
      "type": "STRATEGY_EVENT"
    },
    "event": {
      "uuid": "45526",
      "assigned_to": {
        "1": "Example Name"
      },
      "extended_assigned_to": {
        "1": {
          "name": "Example Name",
          "email": "email@example.com",
          "primary": "true"
        }
      },
      "utc_start_time": "2023-02-15T16:00:00+01:00",
      "utc_end_time": "2023-02-15T16:00:00+01:00",
      "start_time": "2023-02-15T18:00:00+01:00",
      "start_time_pretty": "06:00pm - Wednesday, February 15, 2023",
      "invitee_start_time": "2023-02-15T18:00:00+01:00",
      "invitee_start_time_pretty": "06:00pm - Wednesday, February 15, 2023",
      "end_time": "2023-02-15T18:30:00+01:00",
      "end_time_pretty": "06:30pm - Wednesday, February 15, 2023",
      "invitee_end_time": "2023-02-15T18:30:00+01:00",
      "invitee_end_time_pretty": "06:30pm - Wednesday, February 15, 2023",
      "created_at": "2023-02-14T22:11:30+01:00",
      "type": "STRATEGY_CALL",
      "location": "https://app.iclosed.io/e/event-name",
      "canceled": false,
      "canceler_name": null,
      "cancel_reason": null,
      "canceled_at": null,
      "setter": {
        "firstName": "Setter",
        "lastName": "Name",
        "email": ""
      }
    },
    "invitee": {
      "previewUrl": "http://localhost:3000/app/global-data/contacts?preview=abc123",
      "uuid": "ececc9a9-8837-4a4a-b720-e160319e0730",
      "first_name": "null",
      "last_name": "null",
      "name": "invite name",
      "email": "invitee@example.com",
      "text_reminder_number": "+32 123 12 12 12",
      "timezone": "Europe/Berlin",
      "created_at": "2023-02-14T22:11:30+01:00",
      "canceled": false,
      "canceler_name": null,
      "cancel_reason": null,
      "canceled_at": null
    },
    "questions_and_answers": [
      {
        "question": "Phone Number",
        "answer": "+32 123 12 12 12"
      }
    ],
    "questions_and_responses": {
      "question": "Phone Number",
      "response": "+32 123 12 12 12",
      "Phone Number": "+32 123 12 12 12"
    },
    "tracking": {
      "utm_term": "",
      "utm_source": "",
      "utm_medium": "",
      "utm_content": "",
      "utm_campaign": "",
      "first_utm_term": "",
      "first_utm_source": "",
      "first_utm_medium": "",
      "first_utm_content": "",
      "first_utm_campaign": "",
      "utmKey_0": "",
      "utmValue_0": "",
      "utmKey_1": "",
      "utmValue_1": "",
      "utmKey_2": "",
      "utmValue_2": "",
      "utmKey_3": "",
      "utmValue_3": "",
      "utmKey_4": "",
      "utmValue_4": ""
    },
    "hookType": "Call booked"
  }
]
```

## Key Fields Explained

### Event Type Information

* **`event_type`**: Configuration details of the event type
  * **`uuid`**: Unique identifier for the event type
  * **`kind`**: Booking strategy (e.g., "Round Robin", "Direct Assignment")
  * **`slug`**: URL-friendly event name
  * **`name`**: Display name of the event
  * **`duration`**: Call duration in the specified unit
  * **`durationUnit`**: Time unit (MINUTES, HOURS)
  * **`owner.type`**: Type of owner (closer, setter, etc.)
  * **`type`**: Event category (STRATEGY\_EVENT, DISCOVERY\_EVENT, etc.)

### Event Details

* **`event`**: Specific call instance information
  * **`uuid`**: Unique call identifier
  * **`assigned_to`**: Simple assignment mapping
  * **`extended_assigned_to`**: Detailed assignment information with contact details
  * **`utc_start_time`/`utc_end_time`**: UTC timestamps for the call
  * **`start_time`/`end_time`**: Local timezone timestamps
  * **`start_time_pretty`/`end_time_pretty`**: Human-readable time formats
  * **`invitee_start_time`/`invitee_end_time`**: Times from invitee's perspective
  * **`type`**: Call type (STRATEGY\_CALL, DISCOVERY\_CALL, etc.)
  * **`location`**: Meeting URL or location
  * **`canceled`**: Whether the call has been canceled
  * **`setter`**: Information about the setter assigned to the call

### Invitee Information

* **`invitee`**: Details about the person who booked the call
  * **`previewUrl`**: Direct link to view the contact in iClosed.io
  * **`uuid`**: Unique invitee identifier
  * **`name`**: Full name of the invitee
  * **`email`**: Invitee's email address
  * **`text_reminder_number`**: Phone number for SMS reminders
  * **`timezone`**: Invitee's timezone
  * **`created_at`**: When the invitee was created
  * **`canceled`**: Whether the invitee has canceled

### Questions and Responses

* **`questions_and_answers`**: Array format of booking form responses
* **`questions_and_responses`**: Object format with both question/response pairs and direct key-value mapping

### Tracking Information

* **`tracking`**: UTM parameters and attribution data
  * Current UTM values and first-touch attribution
  * Custom tracking parameters (utmKey\_0 through utmKey\_4)

## Call Types

### Strategy Calls

* **Purpose**: Sales strategy and qualification calls
* **Duration**: Typically 15-30 minutes
* **Owner**: Usually a closer or sales representative

### Discovery Calls

* **Purpose**: Initial discovery and qualification
* **Duration**: Typically 15-30 minutes
* **Owner**: Usually a setter or SDR

### Other Call Types

* **Consultation Calls**: Expert advice sessions
* **Demo Calls**: Product demonstrations
* **Follow-up Calls**: Post-meeting discussions

## Use Cases

This webhook is useful for:

* **CRM Integration**: Create or update records in your CRM system
* **Calendar Synchronization**: Add events to team calendars
* **Notification Systems**: Send confirmations to team members
* **Analytics Tracking**: Monitor booking patterns and conversion rates
* **Workflow Automation**: Trigger follow-up actions based on call bookings
* **Reporting**: Track booking metrics and team performance
* **Customer Communication**: Send personalized confirmation emails

## Response Requirements

Your webhook endpoint should:

* Return a **2xx status code** to acknowledge receipt
* Respond within **5 seconds** to avoid retries
* Handle duplicate events (idempotency)
* Log the call UUID and invitee information for debugging
* Consider timezone differences when processing timestamps

## Best Practices

1. **Timezone Handling**: Always use the provided timezone information
2. **Duplicate Prevention**: Use the call UUID to prevent duplicate processing
3. **Assignment Tracking**: Monitor the `assigned_to` field for team notifications
4. **Cancelation Status**: Check the `canceled` flags before processing
5. **Contact Linking**: Use the `previewUrl` to link back to the contact record
6. **Reminder Setup**: Use `text_reminder_number` for SMS reminder systems
7. **Tracking Attribution**: Preserve UTM data for marketing attribution