Create One-Off Event Type | Calendly | Developer Documentation

import { CalendlyClient } from "calendly";
async function main() {
    const client = new CalendlyClient({
        token: "YOUR_TOKEN_HERE",
    });
    await client.eventTypes.createOneOffEventType({
        name: "My Meeting",
        host: "https://api.calendly.com/users/AAAAAAAAAAAAAAAA",
        coHosts: [
            "https://api.calendly.com/users/BBBBBBBBBBBBBBBB",
            "https://api.calendly.com/users/CCCCCCCCCCCCCCCC",
        ],
        duration: 30,
        timezone: "America/New_York",
        dateSetting: {
            type: "date_range",
            startDate: "2020-01-07",
            endDate: "2020-01-09",
        },
        location: {
            kind: "physical",
            location: "Main Office",
            additionalInfo: "Please check in at the front desk.",
        },
    });
}
main();

{
  "resource": {
    "active": true,
    "admin_managed": false,
    "booking_method": "instant",
    "color": "#fff200",
    "created_at": "2019-01-02T03:04:05.678123Z",
    "custom_questions": [],
    "deleted_at": null,
    "description_html": "<p>Event type description</p>",
    "description_plain": "Event type description",
    "duration": 30,
    "duration_options": null,
    "internal_note": "Event type note",
    "is_paid": false,
    "kind": "solo",
    "locale": "en",
    "locations": [
      {
        "kind": "physical",
        "location": "Main Office",
        "additional_info": "Please check in at the front desk."
      }
    ],
    "name": "My Meeting",
    "pooling_type": "collective",
    "position": 0,
    "profile": {
      "type": "User",
      "name": "Tamara Jones",
      "owner": "https://api.calendly.com/users/AAAAAAAAAAAAAAAA"
    },
    "scheduling_url": "https://calendly.com/acmesales",
    "secret": true,
    "slug": "acmesales",
    "type": "AdhocEventType",
    "updated_at": "2019-08-07T06:05:04.321123Z",
    "uri": "https://api.calendly.com/event_types/AAAAAAAAAAAAAAAA"
  }
}

Creates One-Off Event Type

Required scopes

event_types:write

Creates One-Off Event Type <Info title="Required scopes"> > `event_types:write` </Info>

Authentication

AuthorizationBearer

OAuth 2.0

AuthorizationBearer

Personal Access Token

Request

Parameters for creating One-Off Event Type

namestringRequired<=55 characters

Event type name

hoststringRequiredformat: "uri"

Host user uri

durationdoubleRequired<=720

Duration of meeting in minutes

date_settingobjectRequired

co_hostslist of stringsOptional

Collection of meeting co-host(s) user URIs

timezonestringOptional

Time zone used for meeting. Defaults to host's time zone.

locationobjectOptional

Response

Created

resourceobject

A configuration for an Event Type

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error