Update Meeting Template

put

https://api.joinpopp.com/v1/meeting-templates/{templateId}

Updates a calendar meeting template by ID. Replaces the meeting configuration
with the provided payload (full replacement semantics — every field that
should be present on the resulting template must be supplied).

Returns 404 if the template does not exist, or if it belongs to a different
organisation than the one tied to the API key.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

templateId

string

required

The unique identifier of the meeting template

Body Params

The updated meeting template configuration

meetingParticipants

array of objects

required

length ≥ 1

List of participants for the meeting. Exactly one participant must be marked as organizer.

Meeting Participants*

title

string

required

The title of the meeting.

description

string

A description for the meeting that will be included in the calendar invite.

openHours

array of objects

required

length ≥ 1

Available time windows for scheduling the meeting.

Open Hours*

timezone

string

required

IANA timezone string for the meeting.

duration

integer

required

1 to 1440

The duration of the meeting in minutes.

videoConferencing

boolean

required

Whether to include video conferencing for the meeting. If true, videoConferencingProvider is required and location cannot be specified.

videoConferencingProvider

string

enum

The video conferencing provider to use. Required when videoConferencing is true.

Allowed:

location

string

The physical location for the meeting. Cannot be used when videoConferencing is enabled.

buffer

integer

required

0 to 120

Buffer time in minutes before/after meetings. Must be a multiple of 5.

reminderMinutesBeforeMeeting

integer

required

≥ 1

How many minutes before the meeting to send a reminder notification.

noticePeriodMinutes

integer

required

≥ 0

Minimum notice required for booking in minutes.

availableDaysInTheFuture

integer

required

≥ 1

How many days in the future bookings are available.

guestLabel

string

length between 1 and 50

Noun used in the availability-outreach email for the counterparty the interviewer is scheduled to meet — the person who books the slot. Applies to the whole meeting. Defaults to "candidate"; override with e.g. "recruiter". Must not begin with "the" (Popp prefixes it automatically).

availabilityOutreachSettings

object

Template-level settings for availability outreach emails sent to participants with autoCollectAvailability enabled. Per-participant overrides take priority over these values. See the Scheduling with Availability Collection guide for details.

Responses

200

400

401

404

500