Webhook Events

This page documents the payload structure for each webhook event type.

booking_created

Triggered when a new appointment is booked.

Payload

{
  "webhookType": "booking_created",
  "id": "appt-uuid-12345",
  "secret": "secret-token-xyz",
  "start": "2024-01-15T09:00:00+01:00",
  "end": "2024-01-15T09:30:00+01:00",
  "location": null,
  "isCancelled": false,
  "rescheduledAt": null,
  "meetingInfo": {
    "channel": "zoom",
    "meetingLink": "https://zoom.us/j/123456789"
  },
  "attendees": [
    {
      "id": "att-uuid-789",
      "email": "customer@example.com",
      "firstname": "Jane",
      "lastname": "Doe",
      "fullname": "Jane Doe",
      "phone": "+1-555-123-4567",
      "timezone": "America/New_York",
      "language": "en"
    }
  ],
  "hosts": [
    {
      "id": "host-uuid-123",
      "email": "john@example.com",
      "givenName": "John",
      "familyName": "Smith",
      "fullName": "John Smith",
      "slug": "john-smith",
      "picture": "https://example.com/photo.jpg"
    }
  ],
  "hostIds": ["host-uuid-123"],
  "meetingType": {
    "id": "mt-uuid-456",
    "slug": "discovery-call",
    "meetingInfo": {
      "name": "Discovery Call",
      "duration": 30
    },
    "metadata": {
      "ticketId": "EVAL-12345",
      "source": "crm-integration"
    }
  },
  "meetingTypeId": "mt-uuid-456",
  "companyId": "company-uuid-789",
  "createdAt": "2024-01-14T15:30:00Z",
  "updatedAt": "2024-01-14T15:30:00Z"
}

Key Fields

Field	Type	Description
`id`	string	Unique appointment identifier
`secret`	string	Token for cancel/reschedule operations
`start`	string	Start time (ISO 8601)
`end`	string	End time (ISO 8601)
`attendees`	array	List of attendee objects
`hosts`	array	List of host objects
`meetingType`	object	Meeting type details
`meetingType.metadata`	object	Custom key-value data set when creating the meeting type
`meetingInfo.channel`	string	Video platform used
`meetingInfo.meetingLink`	string	Video meeting URL

booking_cancelled

Triggered when an appointment is cancelled by the host or attendee. For group bookings, this also fires when a single attendee cancels their spot — in that case isCancelled is false (the appointment remains active for other attendees) but the cancel object is still populated.

Payload

{
  "webhookType": "booking_cancelled",
  "id": "appt-uuid-12345",
  "secret": "secret-token-xyz",
  "start": "2024-01-15T09:00:00+01:00",
  "end": "2024-01-15T09:30:00+01:00",
  "location": null,
  "isCancelled": true,
  "cancel": {
    "actionAt": "2024-01-14T18:00:00Z",
    "actionSource": "attendee",
    "reason": "Schedule conflict",
    "actionBy": null
  },
  "attendees": [
    {
      "id": "att-uuid-789",
      "email": "customer@example.com",
      "firstname": "Jane",
      "lastname": "Doe",
      "fullname": "Jane Doe"
    }
  ],
  "hosts": [
    {
      "id": "host-uuid-123",
      "email": "john@example.com",
      "givenName": "John",
      "familyName": "Smith",
      "fullName": "John Smith"
    }
  ],
  "hostIds": ["host-uuid-123"],
  "meetingType": {
    "id": "mt-uuid-456",
    "slug": "discovery-call"
  },
  "meetingTypeId": "mt-uuid-456",
  "companyId": "company-uuid-789",
  "createdAt": "2024-01-14T15:30:00Z",
  "updatedAt": "2024-01-14T18:00:00Z"
}

Key Fields

Field	Type	Description
`isCancelled`	boolean	`true` for full cancellations, `false` when a single attendee leaves a group booking
`cancel.actionAt`	string	When the cancellation occurred (ISO 8601)
`cancel.actionSource`	string	Who cancelled: `attendee`, `host`, or `company` (admin)
`cancel.reason`	string \| null	Optional cancellation reason
`cancel.actionBy`	object \| null	Host/admin who cancelled. `null` when the attendee cancels
`cancel.actionBy.id`	string	User ID of the host/admin
`cancel.actionBy.email`	string	Email of the host/admin

booking_rescheduled

Triggered when an appointment is moved to a new time.

Payload

{
  "webhookType": "booking_rescheduled",
  "oldStartDate": "2024-01-15T09:00:00+01:00",
  "rescheduledAppointment": {
    "id": "appt-uuid-12345",
    "secret": "secret-token-xyz",
    "start": "2024-01-16T10:00:00+01:00",
    "end": "2024-01-16T10:30:00+01:00",
    "location": null,
    "isCancelled": false,
    "rescheduledAt": "2024-01-14T18:30:00Z",
    "attendees": [
      {
        "id": "att-uuid-789",
        "email": "customer@example.com",
        "firstname": "Jane",
        "lastname": "Doe",
        "fullname": "Jane Doe"
      }
    ],
    "hosts": [
      {
        "id": "host-uuid-123",
        "email": "john@example.com",
        "givenName": "John",
        "familyName": "Smith",
        "fullName": "John Smith"
      }
    ],
    "hostIds": ["host-uuid-123"],
    "meetingType": {
      "id": "mt-uuid-456",
      "slug": "discovery-call"
    },
    "meetingTypeId": "mt-uuid-456",
    "companyId": "company-uuid-789",
    "createdAt": "2024-01-14T15:30:00Z",
    "updatedAt": "2024-01-14T18:30:00Z"
  }
}

Key Fields

Field	Type	Description
`oldStartDate`	string	Original start time
`rescheduledAppointment`	object	Updated appointment details
`rescheduledAppointment.start`	string	New start time
`rescheduledAppointment.rescheduledAt`	string	When the reschedule occurred

new_employee

Triggered when a new user is added to your company.

Payload

{
  "webhookType": "new_employee",
  "id": "user-uuid-456",
  "email": "new.hire@example.com",
  "givenName": "Sarah",
  "familyName": "Johnson",
  "fullName": "Sarah Johnson",
  "companyId": "company-uuid-789",
  "userType": "REGULAR",
  "createdAt": "2024-01-14T10:00:00Z"
}

Key Fields

Field	Type	Description
`id`	string	User’s unique identifier
`email`	string	User’s email address
`givenName`	string	First name
`familyName`	string	Last name
`userType`	string	`REGULAR` or `API_PLATFORM`

form_submission

Triggered when someone submits a routing form or funnel.

Payload

{
  "webhookType": "form_submission",
  "formId": "form-uuid-123",
  "formName": "Contact Form",
  "formSlug": "contact-form",
  "companyId": "company-uuid-789",
  "workspaceId": "workspace-uuid-456",
  "submissionData": {
    "company_size": "50-200",
    "use_case": "sales"
  },
  "submittedAt": "2024-01-15T10:00:00.000Z",
  "contact": {
    "id": "contact-uuid-789",
    "email": "lead@example.com",
    "firstName": "Sarah",
    "lastName": "Johnson",
    "phoneNumber": "+1-555-987-6543"
  }
}

Key Fields

Field	Type	Description
`formId`	string	Unique form identifier
`formName`	string	Display name of the form
`formSlug`	string	URL-friendly form identifier
`submissionData`	object	Key-value pairs from form fields
`submittedAt`	string	When the form was submitted (ISO 8601)
`contact`	object \| null	Contact info if available
`contact.email`	string	Contact’s email address

Common Attendee Fields

All booking events include attendee information:

Field	Type	Description
`id`	string	Attendee record ID
`email`	string	Email address
`firstname`	string	First name
`lastname`	string	Last name
`fullname`	string	Combined full name
`phone`	string	Phone number (if provided)
`timezone`	string	Attendee’s timezone
`language`	string	Preferred language code
`notes`	string	Notes from booking form
`attendeeEnrichment`	object	Enriched data from integrations

Common Host Fields

All booking events include host information:

Field	Type	Description
`id`	string	Host user ID
`email`	string	Email address
`givenName`	string	First name
`familyName`	string	Last name
`fullName`	string	Combined full name
`slug`	string	URL-friendly identifier
`picture`	string	Profile photo URL

Handling Events

Example: Sync to CRM

async function handleBookingCreated(payload) {
  const attendee = payload.attendees[0];

  // Create or update contact in your CRM
  await crm.contacts.upsert({
    email: attendee.email,
    firstName: attendee.firstname,
    lastName: attendee.lastname,
    phone: attendee.phone,
    lastMeetingDate: payload.start,
    meetingType: payload.meetingType.meetingInfo.name
  });

  // Log the activity
  await crm.activities.create({
    type: 'meeting_scheduled',
    contactEmail: attendee.email,
    subject: `${payload.meetingType.meetingInfo.name} scheduled`,
    scheduledAt: payload.start,
    hostEmail: payload.hosts[0].email
  });
}

Example: Send Slack Notification

async function handleBookingCreated(payload) {
  const attendee = payload.attendees[0];
  const host = payload.hosts[0];

  await slack.chat.postMessage({
    channel: '#bookings',
    text: `New booking!`,
    blocks: [
      {
        type: 'section',
        text: {
          type: 'mrkdwn',
          text: `*New ${payload.meetingType.meetingInfo.name}*\n` +
                `Attendee: ${attendee.fullname} (${attendee.email})\n` +
                `Host: ${host.fullName}\n` +
                `Time: ${new Date(payload.start).toLocaleString()}`
        }
      }
    ]
  });
}

Example: Correlate with External Ticket

Use metadata to link bookings back to external systems (e.g., CRM tickets, support cases):

async function handleBookingCreated(payload) {
  // Access custom metadata set when creating the meeting type
  const ticketId = payload.meetingType.metadata?.ticketId;

  if (ticketId) {
    // Update your ticket system with the booking details
    await ticketSystem.updateTicket(ticketId, {
      status: 'appointment_scheduled',
      appointmentTime: payload.start,
      appointmentId: payload.id,
      attendeeEmail: payload.attendees[0].email,
      hostName: payload.hosts[0].fullName
    });

    // Optionally clean up the meeting type after booking
    await fetch(`https://api.meetergo.com/v4/meeting-type/${payload.meetingType.id}`, {
      method: 'DELETE',
      headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'x-meetergo-api-user-id': payload.hosts[0].id
      }
    });
  }
}

The metadata field is set when creating the meeting type and is included in all booking webhooks. Use it to correlate bookings with your external systems.

Get Started

Core Concepts

Webhooks

Components

Recipes

Best Practices

booking_created

Payload

Key Fields

booking_cancelled

Payload

Key Fields

booking_rescheduled

Payload

Key Fields

new_employee

Payload

Key Fields

form_submission

Payload

Key Fields

Common Attendee Fields

Common Host Fields

Handling Events

Example: Sync to CRM

Example: Send Slack Notification

Example: Correlate with External Ticket

​booking_created

​Payload

​Key Fields

​booking_cancelled

​Payload

​Key Fields

​booking_rescheduled

​Payload

​Key Fields

​new_employee

​Payload

​Key Fields

​form_submission

​Payload

​Key Fields

​Common Attendee Fields

​Common Host Fields

​Handling Events

​Example: Sync to CRM

​Example: Send Slack Notification

​Example: Correlate with External Ticket

booking_created

Payload

Key Fields

booking_cancelled

Payload

Key Fields

booking_rescheduled

Payload

Key Fields

new_employee

Payload

Key Fields

form_submission

Payload

Key Fields

Common Attendee Fields

Common Host Fields

Handling Events

Example: Sync to CRM

Example: Send Slack Notification

Example: Correlate with External Ticket