Group Events

Validate time slot

Changed on

Validates whether the selected group event or time slot has changed, and is invalid. This can happen because...

  • The group event was deleted.
  • The group event was updated (for example, the start time was changed).
  • The capacity for the event was changed.
post/v3/scheduling/configurations/{configuration_id}/group-events/validate-timeslot

Request

  • Base URL
    https://api.us.nylas.com
  • Auth
    HTTP bearer

Request body

calendar_idstring required

ID of the calendar to access.

capacitynumber

The maximum number of attendees for the event. If not specified, Nylas uses the default capacity for your Configuration.

end_timeinteger required

The end time of the time slot, in seconds using the Unix timestamp format. Nylas compares this to the event's current end time to detect whether it was rescheduled.

emailsstring[]

A list of email addresses associated with the event's participants.

event_idstring required

ID of the event to validate.

master_idstring

The master event ID. Required when working with recurring events.

start_timeinteger required

The start time of the time slot, in seconds using the Unix timestamp format. Nylas compares this to the event's current start time to detect whether it was rescheduled.

Example request

{
  "calendar_id": "primary",
  "capacity": 50,
  "end_time": 1744290000,
  "emails": [
    "nyla@example.com",
    "leyah@example.com"
  ],
  "event_id": "5d3qmne77v32r8l4phyuksl2x",
  "master_id": "5d3qmne77v32r8l4phyuksl2x",
  "start_time": 1744286400
}

Response

Time slot validated

request_idstring

ID of the request.

Example response

{
  "request_id": "5967ca40-a2d8-4ee0-a0e0-6f18ace39a90"
}

Changes

    • breaking

      added the new required request property

    • breaking

      added the new required request property

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status