> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Create Booking

- Component: `appmixer.calcom.core.CreateBooking`
- Kind: Action
- Version: 1.0.0
- Visibility: Public
- Connector: [appmixer.calcom 1.0.0](https://connectors.appmixer.com/connector/appmixer.calcom/1.0.0.md)
- Component page: <https://connectors.appmixer.com/connector/appmixer.calcom/1.0.0/component/appmixer.calcom.core.CreateBooking>

Book a meeting of an event type for an attendee. The start time must be a free slot of the event type: use Find Available Slots to get one. For a recurring event type the first occurrence is returned.

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| Event Type (`eventTypeId`) | text | Pick the event type to book, or type its Event Type ID. |
| Start (`start`) | date-time | Start of the booking. It is sent to Cal.com in UTC and must match an available slot. |
| Attendee Name (`attendeeName`) | text | Full name of the person booking the meeting. |
| Attendee Email (`attendeeEmail`) | text | Email of the attendee. Cal.com sends the confirmation to this address. |
| Attendee Time Zone (`attendeeTimeZone`) | text | IANA time zone of the attendee, for example `Europe/Prague` or `America/New_York`. |
| Attendee Phone Number (`attendeePhoneNumber`) | text | Phone number in international format, for example `+14155552671`. Needed when the event type asks for it. |
| Attendee Language (`attendeeLanguage`) | text | Language of the confirmation, for example `en`, `de` or `pt-BR`. Defaults to English. |
| Guests (`guests`) | textarea | Emails of additional guests, separated by commas or new lines. |
| Length (Minutes) (`lengthInMinutes`) | number | Only for event types that offer several lengths. Leave empty to use the default length. |
| Booking Field Responses (`bookingFieldsResponses`) | textarea | Answers to custom booking questions of the event type as a JSON object keyed by the booking field slug, for example `{"company": "Acme"}`. |
| Metadata (`metadata`) | textarea | Additional data to store with the booking as a JSON object of strings (at most 50 keys), for example `{"crmId": "42"}`. |

## Output ports

### Port `out`

| Field | Type | Description |
| --- | --- | --- |
| Booking ID (`id`) | integer | - |
| Booking UID (`uid`) | string | - |
| Title (`title`) | string | - |
| Description (`description`) | string | - |
| Status (`status`) | string | - |
| Start (`start`) | string | - |
| End (`end`) | string | - |
| Duration (Minutes) (`duration`) | integer | - |
| Event Type ID (`eventTypeId`) | integer | - |
| Event Type (`eventType`) | object | - |
| Location (`location`) | string | - |
| Meeting URL (`meetingUrl`) | string | - |
| Absent Host (`absentHost`) | boolean | - |
| Hosts (`hosts`) | array | - |
| Attendees (`attendees`) | array | - |
| Guests (`guests`) | array | - |
| Cancellation Reason (`cancellationReason`) | string | - |
| Cancelled By Email (`cancelledByEmail`) | string | - |
| Rescheduling Reason (`reschedulingReason`) | string | - |
| Rescheduled By Email (`rescheduledByEmail`) | string | - |
| Rescheduled From UID (`rescheduledFromUid`) | string | - |
| Rescheduled To UID (`rescheduledToUid`) | string | - |
| Recurring Booking UID (`recurringBookingUid`) | string | - |
| Created At (`createdAt`) | string | - |
| Updated At (`updatedAt`) | string | - |

## Full metadata (component.json)

```json
{
  "name": "appmixer.calcom.core.CreateBooking",
  "label": "Create Booking",
  "description": "Book a meeting of an event type for an attendee. The start time must be a free slot of the event type: use Find Available Slots to get one. For a recurring event type the first occurrence is returned.",
  "author": "Appmixer <info@appmixer.com>",
  "version": "1.0.0",
  "auth": {
    "service": "appmixer:calcom"
  },
  "quota": {
    "manager": "appmixer:calcom",
    "resources": "requests",
    "scope": {
      "userId": "{{userId}}"
    }
  },
  "inPorts": [
    {
      "name": "in",
      "schema": {
        "type": "object",
        "properties": {
          "eventTypeId": {
            "type": "string"
          },
          "start": {
            "type": "string",
            "format": "date-time"
          },
          "attendeeName": {
            "type": "string"
          },
          "attendeeEmail": {
            "type": "string"
          },
          "attendeeTimeZone": {
            "type": "string"
          },
          "attendeePhoneNumber": {
            "type": "string"
          },
          "attendeeLanguage": {
            "type": "string"
          },
          "guests": {
            "type": "string"
          },
          "lengthInMinutes": {
            "type": "integer"
          },
          "bookingFieldsResponses": {
            "type": "string"
          },
          "metadata": {
            "type": "string"
          }
        },
        "required": [
          "eventTypeId",
          "start",
          "attendeeName",
          "attendeeTimeZone"
        ]
      },
      "inspector": {
        "inputs": {
          "eventTypeId": {
            "type": "text",
            "index": 1,
            "label": "Event Type",
            "tooltip": "Pick the event type to book, or type its Event Type ID.",
            "source": {
              "url": "/component/appmixer/calcom/core/ListEventTypes?outPort=out",
              "data": {
                "properties": {
                  "isSource": true
                },
                "transform": "./ListEventTypes#toSelectArray"
              }
            }
          },
          "start": {
            "type": "date-time",
            "index": 2,
            "label": "Start",
            "tooltip": "Start of the booking. It is sent to Cal.com in UTC and must match an available slot."
          },
          "attendeeName": {
            "type": "text",
            "index": 3,
            "label": "Attendee Name",
            "tooltip": "Full name of the person booking the meeting."
          },
          "attendeeEmail": {
            "type": "text",
            "index": 4,
            "label": "Attendee Email",
            "tooltip": "Email of the attendee. Cal.com sends the confirmation to this address."
          },
          "attendeeTimeZone": {
            "type": "text",
            "index": 5,
            "label": "Attendee Time Zone",
            "tooltip": "IANA time zone of the attendee, for example <code>Europe/Prague</code> or <code>America/New_York</code>."
          },
          "attendeePhoneNumber": {
            "type": "text",
            "index": 6,
            "label": "Attendee Phone Number",
            "tooltip": "Phone number in international format, for example <code>+14155552671</code>. Needed when the event type asks for it."
          },
          "attendeeLanguage": {
            "type": "text",
            "index": 7,
            "label": "Attendee Language",
            "tooltip": "Language of the confirmation, for example <code>en</code>, <code>de</code> or <code>pt-BR</code>. Defaults to English."
          },
          "guests": {
            "type": "textarea",
            "index": 8,
            "label": "Guests",
            "tooltip": "Emails of additional guests, separated by commas or new lines."
          },
          "lengthInMinutes": {
            "type": "number",
            "index": 9,
            "label": "Length (Minutes)",
            "tooltip": "Only for event types that offer several lengths. Leave empty to use the default length."
          },
          "bookingFieldsResponses": {
            "type": "textarea",
            "index": 10,
            "label": "Booking Field Responses",
            "tooltip": "Answers to custom booking questions of the event type as a JSON object keyed by the booking field slug, for example <code>{\"company\": \"Acme\"}</code>."
          },
          "metadata": {
            "type": "textarea",
            "index": 11,
            "label": "Metadata",
            "tooltip": "Additional data to store with the booking as a JSON object of strings (at most 50 keys), for example <code>{\"crmId\": \"42\"}</code>."
          }
        }
      }
    }
  ],
  "outPorts": [
    {
      "name": "out",
      "schema": {
        "type": "object",
        "required": [
          "id",
          "uid",
          "title",
          "status",
          "start",
          "end",
          "duration",
          "eventTypeId",
          "hosts",
          "attendees",
          "createdAt"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "title": "Booking ID",
            "example": 4567890
          },
          "uid": {
            "type": "string",
            "title": "Booking UID",
            "example": "k3b7Xq9ZpR2mN8vT4wYc1a"
          },
          "title": {
            "type": "string",
            "title": "Title",
            "example": "30 Min Meeting between Jane Doe and John Smith"
          },
          "description": {
            "type": "string",
            "title": "Description",
            "example": "Quarterly planning call."
          },
          "status": {
            "type": "string",
            "title": "Status",
            "example": "accepted"
          },
          "start": {
            "type": "string",
            "title": "Start",
            "example": "2026-12-01T09:00:00.000Z",
            "format": "date-time"
          },
          "end": {
            "type": "string",
            "title": "End",
            "example": "2026-12-01T09:30:00.000Z",
            "format": "date-time"
          },
          "duration": {
            "type": "integer",
            "title": "Duration (Minutes)",
            "example": 30
          },
          "eventTypeId": {
            "type": "integer",
            "title": "Event Type ID",
            "example": 1234567
          },
          "eventType": {
            "type": "object",
            "title": "Event Type",
            "properties": {
              "id": {
                "type": "integer",
                "title": "Event Type.ID",
                "example": 1234567
              },
              "slug": {
                "type": "string",
                "title": "Event Type.Slug",
                "example": "30min"
              }
            }
          },
          "location": {
            "type": "string",
            "title": "Location",
            "example": "https://app.cal.com/video/k3b7Xq9ZpR2mN8vT4wYc1a"
          },
          "meetingUrl": {
            "type": "string",
            "title": "Meeting URL",
            "example": "https://app.cal.com/video/k3b7Xq9ZpR2mN8vT4wYc1a"
          },
          "absentHost": {
            "type": "boolean",
            "title": "Absent Host",
            "example": false
          },
          "hosts": {
            "type": "array",
            "title": "Hosts",
            "example": [
              {
                "id": 112233,
                "name": "Jane Doe",
                "email": "jane@example.com",
                "username": "jane",
                "timeZone": "Europe/Prague"
              }
            ],
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "integer",
                  "title": "Hosts.ID",
                  "example": 112233
                },
                "name": {
                  "type": "string",
                  "title": "Hosts.Name",
                  "example": "Jane Doe"
                },
                "email": {
                  "type": "string",
                  "title": "Hosts.Email",
                  "example": "jane@example.com"
                },
                "username": {
                  "type": "string",
                  "title": "Hosts.Username",
                  "example": "jane"
                },
                "timeZone": {
                  "type": "string",
                  "title": "Hosts.Time Zone",
                  "example": "Europe/Prague"
                }
              }
            }
          },
          "attendees": {
            "type": "array",
            "title": "Attendees",
            "example": [
              {
                "name": "John Smith",
                "email": "john@example.com",
                "timeZone": "America/New_York",
                "language": "en",
                "absent": false
              }
            ],
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "title": "Attendees.Name",
                  "example": "John Smith"
                },
                "email": {
                  "type": "string",
                  "title": "Attendees.Email",
                  "example": "john@example.com"
                },
                "timeZone": {
                  "type": "string",
                  "title": "Attendees.Time Zone",
                  "example": "America/New_York"
                },
                "language": {
                  "type": "string",
                  "title": "Attendees.Language",
                  "example": "en"
                },
                "phoneNumber": {
                  "type": "string",
                  "title": "Attendees.Phone Number",
                  "example": "+14155552671"
                },
                "absent": {
                  "type": "boolean",
                  "title": "Attendees.Absent",
                  "example": false
                }
              }
            }
          },
          "guests": {
            "type": "array",
            "title": "Guests",
            "items": {
              "type": "string"
            },
            "example": [
              "guest@example.com"
            ]
          },
          "cancellationReason": {
            "type": "string",
            "title": "Cancellation Reason",
            "example": "The attendee can no longer attend."
          },
          "cancelledByEmail": {
            "type": "string",
            "title": "Cancelled By Email",
            "example": "john@example.com"
          },
          "reschedulingReason": {
            "type": "string",
            "title": "Rescheduling Reason",
            "example": "Moved to the afternoon."
          },
          "rescheduledByEmail": {
            "type": "string",
            "title": "Rescheduled By Email",
            "example": "john@example.com"
          },
          "rescheduledFromUid": {
            "type": "string",
            "title": "Rescheduled From UID",
            "example": "h2c6Wp8YoQ1lM7uS3vXb0z"
          },
          "rescheduledToUid": {
            "type": "string",
            "title": "Rescheduled To UID",
            "example": "p4d8Zr0AqS3nO9wU5xYe2b"
          },
          "recurringBookingUid": {
            "type": "string",
            "title": "Recurring Booking UID",
            "example": "6f1c2d3e-4a5b-4c6d-8e7f-9a0b1c2d3e4f"
          },
          "createdAt": {
            "type": "string",
            "title": "Created At",
            "example": "2026-11-16T10:15:00.000Z",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "title": "Updated At",
            "example": "2026-11-16T10:15:00.000Z",
            "format": "date-time"
          }
        }
      }
    }
  ],
  "icon": "(data URI omitted)"
}
```
