Skip to main content

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.

​
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: 
[
  {
    "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