Booking links

Create a link type (personal, or a team link with `team`)

With team set, invitees get an email with a Join button (/join/<token>); before they join, their free/busy is read only through YOUR calendar account when your org lets you see it. Every teammate is checked against their own working hours. Personal links may set weeklyHours and hoursTimezone together for link-specific availability; team links reject this override. teamHandle gives a team link its own address (whenmeet.me/@acme-sales); it is claimed before any invite goes out, and a taken handle undoes the create (409). Reminder emails go out 24 h and 1 h before by default (reminders).

post/api/event-types

Request

  • Base URL: https://whenmeet.me
  • URL: https://whenmeet.me/api/event-types
  • Auth: one of:
    • HTTP bearer
    • API key in cookie __Host-session

Request body

titlestring
slugstring

Default: from the title (-2, -3 … appended if taken).

descriptionstring nullable
durationMininteger
conference'meet' | 'teams' | 'null' nullable

Default: meet for a Google calendar, teams for Microsoft.

bufferBeforeMininteger
bufferAfterMininteger
minNoticeMininteger
maxDaysAheadinteger
slotStepMin5 | 10 | 15 | 20 | 30 | 45 | 60 | 90 | 120
dailyLimitinteger nullable
hoursTimezonestring nullable

IANA timezone for weeklyHours. A non-null weeklyHours needs a valid non-null zone; clear both to follow the profile (invalid_hours_timezone on a mismatched pair).

remindersinteger[]

Reminder emails to the invitee and guests, in minutes before the start (24 h and 1 h by default). Any 3 of the allowed values; duplicates collapse, stored sorted descending. [] turns reminders off; null resets to the default. Error: invalid_reminders.

activeboolean
teamHandlestring nullable

Team links only: the link’s own public address, whenmeet.me/@<teamHandle> (same rules as nicknames and the same namespace; a leading @ and upper case are forgiven). null or "" releases it; turning the link personal releases it too. Errors: invalid_team_handle (bad handle, or the link is / becomes personal), 409 handle_taken (held by any nickname — yours included — or another link; nothing changes), 400 too_many_team_handles (you already hold 5 team handles on other links; nothing changes).

teamNamestring nullable

Shown with the team handle ("Acme Sales"); null → the link title. Stored only next to a team handle (ignored without one). Error: invalid_team_name.

Example request

{
  "weeklyHours": {
    "mon": [
      [
        "09:00",
        "17:00"
      ]
    ],
    "tue": [
      [
        "09:00",
        "12:00"
      ],
      [
        "13:00",
        "17:00"
      ]
    ],
    "sat": [],
    "sun": []
  }
}

Response

{ eventType }

Example response

{
  "eventType": {
    "weeklyHours": {
      "mon": [
        [
          "09:00",
          "17:00"
        ]
      ],
      "tue": [
        [
          "09:00",
          "12:00"
        ],
        [
          "13:00",
          "17:00"
        ]
      ],
      "sat": [],
      "sun": []
    },
    "team": {
      "members": [
        {
          "hours": {
            "weeklyHours": {
              "mon": [
                [
                  "09:00",
                  "17:00"
                ]
              ],
              "tue": [
                [
                  "09:00",
                  "12:00"
                ],
                [
                  "13:00",
                  "17:00"
                ]
              ],
              "sat": [],
              "sun": []
            }
          }
        }
      ]
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.