Call Booked Webhook

​

Overview

​

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

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

• 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

• 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