Reschedule a Scheduled Event - Zeeg Developer Hub

PUT

scheduled-events

{uuid}

reschedule

curl --request PUT \
  --url https://api.zeeg.me/v2/scheduled-events/{uuid}/reschedule \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "date": "2026-04-22",
  "start": "14:30"
}
'

{
  "resource": {
    "uri": "https://api.zeeg.me/v2/scheduled-events/zg-O69bf1a2b3c4d5",
    "uuid": "zg-O69bf1a2b3c4d5",
    "title": "30-Minute Discovery Call",
    "type": "ONE_ON_ONE",
    "startTime": "2026-04-22T12:30:00.000000Z",
    "endTime": "2026-04-22T13:00:00.000000Z",
    "duration": 30,
    "status": "confirmed",
    "eventTypeUri": "https://api.zeeg.me/v2/event-types/80f46bf5-eb01-4c07-960e-a9a3e18aae5e",
    "location": {
      "type": "Google Meet",
      "joinUrl": "https://meet.google.com/abc-defg-hij"
    },
    "maxActiveInvitees": 1,
    "activeInviteesCount": 1,
    "invitees": [
      {
        "uuid": "zg-O69bf6d7e8f901",
        "salutation": "Ms.",
        "fullName": "Sophie Laurent",
        "email": "sophie.laurent@northwind.io",
        "guests": [
          "alex.chen@northwind.io"
        ],
        "timeZone": "Europe/Paris",
        "cancellation": {
          "cancelledAt": null,
          "cancelledBy": null,
          "cancellerType": null,
          "cancellationReason": null
        },
        "payment": null,
        "questions": [
          {
            "answer": "Product demo and pricing options",
            "answer_type": "STRING",
            "question": "What would you like to discuss?"
          }
        ],
        "noShow": false,
        "noShowAt": null,
        "scheduledAt": "2026-04-17T10:00:00.000000Z",
        "utm": {
          "utm_campaign": "spring_launch",
          "utm_source": "linkedin",
          "utm_medium": "social",
          "utm_content": null,
          "utm_term": null
        },
        "customQueryParams": {},
        "cancelUrl": "https://zeeg.me/cancel/zg-O69bf6d7e8f901",
        "rescheduleUrl": "https://zeeg.me/reschedule/zg-O69bf6d7e8f901",
        "rescheduled": false,
        "rescheduling": {
          "oldStartAt": "2026-04-15T09:00:00.000000Z",
          "newStartAt": "2026-04-22T12:30:00.000000Z",
          "rescheduledAt": "2026-04-17T10:00:00.000000Z",
          "previousEventUuid": "zg-O69bac566950c6",
          "previousInviteeUuid": "zg-O69bad4047abf0",
          "reason": "Requested a later slot.",
          "rescheduledBy": "user",
          "reschedulerFullName": "Lena Meier"
        },
        "nextRescheduling": null
      }
    ],
    "guests": [
      "alex.chen@northwind.io"
    ],
    "hosts": [
      {
        "firstName": "Lena",
        "lastName": "Meier",
        "email": "lena.meier@horizondigital.de",
        "slug": "lena-meier",
        "url": "https://zeeg.me/lena-meier",
        "avatarUrl": null
      }
    ],
    "teamName": "Sales",
    "createdAt": "2026-04-17T10:00:00.000000Z",
    "updatedAt": "2026-04-17T10:00:00.000000Z",
    "currentTime": "2026-04-17T10:00:00+00:00"
  }
}

Authorizations

Authorization

string

header

required

Path Parameters

uuid

string<uuid>

required

UUID of a specific scheduled event (zg-XXX format)

Example:

"zg-O69bac566950c6"

Body

application/json

date

string<date>

required

New booking date, in YYYY-MM-DD format.

Example:

"2026-04-22"

start

string

required

New start time, in HH:mm 24-hour format (in the given timeZone).

Example:

"14:30"

timeZone

string | null

IANA time zone for date/start. Defaults to the existing invitee's time zone when omitted.

Example:

"Europe/Paris"

duration

integer | null

New duration in minutes. The event type ignores an unsupported value and uses its own configured duration instead.

Required range: x >= 1

reason

string | null

Optional reason for the reschedule.

Maximum string length: 512

overrideLevel

enum<integer>

Moves the booking to a time the scheduling page does not offer, as far as the level allows. Use it for a move a team member makes, never for an invitee choosing a time.

1: only the times the scheduling page offers (the same as leaving it out).
2: also times the scheduling page's settings block: working hours, buffers, minimum notice, booking limits, the booking window and time off.
3: also times an entry in a host's connected calendar blocks.
4: no availability check on the host: also moves the booking on top of the host's other Zeeg bookings, so the host is double-booked.

No level moves a booking to a time in the past, into a busy room, or into a group event without enough free seats. A refused time returns 400 with data.blockedReason naming what blocks it, for example calendar when level 3 would open it. Needs a token whose user may edit both the scheduling page and the booking; otherwise the request returns 403.

Available options:

1,

2,

3,

4

Example:

2

Response

resource

object

required

A scheduled event resource. This is the single canonical shape returned by all scheduled-event endpoints and embedded in the AI agent call webhook payload.

Hide child attributes

resource.uri

string<uri>

required

Public API URI of the scheduled event resource.

resource.uuid

string

required

Zeeg event identifier (zg-XXX format)

Example:

"zg-O69bac566950c6"

resource.title

string

required

Title of the scheduled event.

resource.type

string

required

Event type kind (e.g. ONE_ON_ONE, GROUP, ROUND_ROBIN).

resource.startTime

string<date-time>

required

ISO 8601 UTC start time of the booked event.

resource.endTime

string<date-time>

required

ISO 8601 UTC end time of the booked event.

resource.duration

integer

required

Event duration in minutes.

resource.status

string

required

Booking status (e.g. confirmed, cancelled).

resource.eventTypeUri

string<uri>

required

Public API URI of the event type this booking was made against.

resource.maxActiveInvitees

integer

required

Maximum number of active invitees the event allows.

resource.activeInviteesCount

integer

required

Current number of active (non-cancelled) invitees.

resource.invitees

object[]

required

Invitees booked on the scheduled event.

Hide child attributes

resource.invitees.fullName

string | null

required

Full name of the invitee.

resource.invitees.email

string<email> | null

required

Email address of the invitee.

resource.invitees.timeZone

string | null

required

IANA time zone of the invitee.

resource.invitees.noShow

boolean

required

Whether the invitee has been marked as a no-show. Always present.

resource.invitees.scheduledAt

string<date-time> | null

required

ISO 8601 UTC timestamp when the invitee booked.

resource.invitees.uuid

string

Zeeg attendee identifier (zg-XXX format)

Example:

"zg-O69bac566950c6"

resource.invitees.salutation

string | null

Salutation for the invitee, if collected.

resource.invitees.guests

string[]

Email addresses of additional guests the invitee added. An empty array when the invitee added none.

resource.invitees.cancellation

object

Cancellation details. All fields are null when the invitee is not cancelled.

Hide child attributes

resource.invitees.cancellation.cancelledAt

string<date-time> | null

ISO 8601 UTC timestamp when the invitee was cancelled.

resource.invitees.cancellation.cancelledBy

string | null

Identifier of who cancelled the booking.

resource.invitees.cancellation.cancellerType

string | null

Type of canceller (e.g. host, invitee).

resource.invitees.cancellation.cancellationReason

string | null

Reason given for the cancellation.

resource.invitees.payment

object | null

Payment details for the booking, or null when no payment applies.

Hide child attributes

resource.invitees.payment.gateway

string

Payment provider, e.g. stripe or paypal.

resource.invitees.payment.price

number

resource.invitees.payment.currency

string

resource.invitees.payment.transactionId

string | null

resource.invitees.payment.createdAt

string<date-time>

resource.invitees.payment.status

enum<string>

pending until the transaction completes.

Available options:

pending,

success

resource.invitees.noShowAt

string<date-time> | null

ISO 8601 UTC timestamp when the invitee was marked as a no-show, or null when they were not.

resource.invitees.utm

object

UTM tracking parameters captured at booking time. Always holds these five keys, in snake_case; a key holds null when the booking did not carry a value for it.

Hide child attributes

resource.invitees.utm.utm_campaign

string | null

required

resource.invitees.utm.utm_source

string | null

required

resource.invitees.utm.utm_medium

string | null

required

resource.invitees.utm.utm_content

string | null

required

resource.invitees.utm.utm_term

string | null

required

resource.invitees.adAttribution

object | null

Ad-click identifiers captured at booking time, keyed by provider. Only the keys that were actually captured are present; null when none were captured.

Hide child attributes

resource.invitees.adAttribution.gclid

string | null

Google Ads click ID.

resource.invitees.adAttribution.gbraid

string | null

Google click ID for iOS app-to-web clicks. Mutually exclusive with gclid per click.

resource.invitees.adAttribution.wbraid

string | null

Google click ID for web-to-app clicks. Mutually exclusive with gclid per click.

resource.invitees.adAttribution.fbclid

string | null

Meta click ID.

resource.invitees.adAttribution.fbp

string | null

Meta browser ID cookie (_fbp) captured at booking time.

resource.invitees.adAttribution.fbc

string | null

Meta click cookie (_fbc) captured at booking time.

resource.invitees.adAttribution.landingUrl

string | null

Full URL of the host page the booking widget was embedded on.

resource.invitees.customQueryParams

object

Custom query parameters captured at booking time, keyed by the c__-prefixed parameter name. An empty object when the booking captured none.

Example:

{ "c__ref": "nl-2026-04" }

resource.invitees.questions

object[] | null

Booking questions answered by the invitee.

Hide child attributes

resource.invitees.questions.answer

string

resource.invitees.questions.answer_type

string

resource.invitees.questions.question

string

resource.invitees.agentBookingReference

string | null

Reference code for bookings made via the AI agent; null otherwise.

resource.invitees.cancelUrl

string<uri> | null

Public URL the invitee uses to cancel this booking. null once the booking is cancelled.

resource.invitees.rescheduleUrl

string<uri> | null

Public URL the invitee uses to reschedule this booking. null once the booking is cancelled.

resource.invitees.rescheduled

boolean

True once this booking has been superseded by a reschedule. A rescheduled booking reports status: cancelled for backward compatibility; rescheduled and nextRescheduling are how a caller tells a reschedule apart from an actual cancellation.

resource.invitees.rescheduling

object | null

Present when this booking is the result of a reschedule. null when this booking was not itself created by rescheduling an earlier one.

Hide child attributes

resource.invitees.rescheduling.oldStartAt

string<date-time> | null

ISO 8601 UTC start time the previous booking held before the reschedule.

resource.invitees.rescheduling.newStartAt

string<date-time> | null

ISO 8601 UTC start time the new booking was moved to.

resource.invitees.rescheduling.rescheduledAt

string<date-time>

ISO 8601 UTC timestamp when the reschedule was performed.

resource.invitees.rescheduling.previousEventUuid

string | null

uuid of the superseded booking (zg-XXX format). Use it directly as the uuid path parameter of GET /scheduled-events/{uuid} to fetch that booking.

Example:

"zg-O69bad4047abf0"

resource.invitees.rescheduling.previousInviteeUuid

string | null

uuid of the invitee on the superseded booking. No public endpoint accepts an invitee uuid as a path parameter.

Example:

"zg-O69bac566950c6"

resource.invitees.rescheduling.reason

string | null

Reason given for the reschedule, if any.

resource.invitees.rescheduling.rescheduledBy

string | null

Who performed the reschedule (e.g. host, invitee).

resource.invitees.rescheduling.reschedulerFullName

string | null

Full name of the person who performed the reschedule, when known.

resource.invitees.nextRescheduling

object | null

Present when this booking has been superseded by a later reschedule. null when the booking has not been rescheduled.

Hide child attributes

resource.invitees.nextRescheduling.oldStartAt

string<date-time> | null

ISO 8601 UTC start time the previous booking held before the reschedule.

resource.invitees.nextRescheduling.newStartAt

string<date-time> | null

ISO 8601 UTC start time the new booking was moved to.

resource.invitees.nextRescheduling.rescheduledAt

string<date-time>

ISO 8601 UTC timestamp when the reschedule was performed.

resource.invitees.nextRescheduling.previousEventUuid

string | null

uuid of the superseded booking (zg-XXX format). Use it directly as the uuid path parameter of GET /scheduled-events/{uuid} to fetch that booking.

Example:

"zg-O69bad4047abf0"

resource.invitees.nextRescheduling.previousInviteeUuid

string | null

uuid of the invitee on the superseded booking. No public endpoint accepts an invitee uuid as a path parameter.

Example:

"zg-O69bac566950c6"

resource.invitees.nextRescheduling.reason

string | null

Reason given for the reschedule, if any.

resource.invitees.nextRescheduling.rescheduledBy

string | null

Who performed the reschedule (e.g. host, invitee).

resource.invitees.nextRescheduling.reschedulerFullName

string | null

Full name of the person who performed the reschedule, when known.

resource.teamName

string | null

required

Name of the team that owns the scheduling page the booking was made on, or null for a personal scheduling page. The key is always present. This is the same value the invitee.scheduled webhook sends as teamName for the same booking.

Example:

"Sales"

resource.createdAt

string<date-time>

required

ISO 8601 UTC timestamp when the booking was created.

resource.location

object | null

Meeting location for the booking.

Hide child attributes

resource.location.type

string

required

Location type (e.g. google_meet, zoom, phone, in_person).

resource.location.joinUrl

string<uri> | null

Join URL for the meeting, when applicable.

resource.guests

string[]

Email addresses of additional guests added across all invitees. An empty array when none were added.

resource.hosts

object[] | null

Hosts assigned to the scheduled event.

Hide child attributes

resource.hosts.firstName

string | null

required

Host's first name.

resource.hosts.email

string<email> | null

required

Host's email address.

resource.hosts.slug

string | null

required

Host's public profile slug.

resource.hosts.url

string<uri>

required

Host's public profile URL.

resource.hosts.lastName

string

Host's last name. Empty string when not set.

resource.hosts.avatarUrl

string<uri> | null

URL of the host's avatar image, if set.

resource.updatedAt

string<date-time>

ISO 8601 UTC timestamp when the booking was last updated.

resource.currentTime

string<date-time>

Current server time

Last modified on August 31, 2026

curl --request PUT \
  --url https://api.zeeg.me/v2/scheduled-events/{uuid}/reschedule \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "date": "2026-04-22",
  "start": "14:30"
}
'

{
  "resource": {
    "uri": "https://api.zeeg.me/v2/scheduled-events/zg-O69bf1a2b3c4d5",
    "uuid": "zg-O69bf1a2b3c4d5",
    "title": "30-Minute Discovery Call",
    "type": "ONE_ON_ONE",
    "startTime": "2026-04-22T12:30:00.000000Z",
    "endTime": "2026-04-22T13:00:00.000000Z",
    "duration": 30,
    "status": "confirmed",
    "eventTypeUri": "https://api.zeeg.me/v2/event-types/80f46bf5-eb01-4c07-960e-a9a3e18aae5e",
    "location": {
      "type": "Google Meet",
      "joinUrl": "https://meet.google.com/abc-defg-hij"
    },
    "maxActiveInvitees": 1,
    "activeInviteesCount": 1,
    "invitees": [
      {
        "uuid": "zg-O69bf6d7e8f901",
        "salutation": "Ms.",
        "fullName": "Sophie Laurent",
        "email": "sophie.laurent@northwind.io",
        "guests": [
          "alex.chen@northwind.io"
        ],
        "timeZone": "Europe/Paris",
        "cancellation": {
          "cancelledAt": null,
          "cancelledBy": null,
          "cancellerType": null,
          "cancellationReason": null
        },
        "payment": null,
        "questions": [
          {
            "answer": "Product demo and pricing options",
            "answer_type": "STRING",
            "question": "What would you like to discuss?"
          }
        ],
        "noShow": false,
        "noShowAt": null,
        "scheduledAt": "2026-04-17T10:00:00.000000Z",
        "utm": {
          "utm_campaign": "spring_launch",
          "utm_source": "linkedin",
          "utm_medium": "social",
          "utm_content": null,
          "utm_term": null
        },
        "customQueryParams": {},
        "cancelUrl": "https://zeeg.me/cancel/zg-O69bf6d7e8f901",
        "rescheduleUrl": "https://zeeg.me/reschedule/zg-O69bf6d7e8f901",
        "rescheduled": false,
        "rescheduling": {
          "oldStartAt": "2026-04-15T09:00:00.000000Z",
          "newStartAt": "2026-04-22T12:30:00.000000Z",
          "rescheduledAt": "2026-04-17T10:00:00.000000Z",
          "previousEventUuid": "zg-O69bac566950c6",
          "previousInviteeUuid": "zg-O69bad4047abf0",
          "reason": "Requested a later slot.",
          "rescheduledBy": "user",
          "reschedulerFullName": "Lena Meier"
        },
        "nextRescheduling": null
      }
    ],
    "guests": [
      "alex.chen@northwind.io"
    ],
    "hosts": [
      {
        "firstName": "Lena",
        "lastName": "Meier",
        "email": "lena.meier@horizondigital.de",
        "slug": "lena-meier",
        "url": "https://zeeg.me/lena-meier",
        "avatarUrl": null
      }
    ],
    "teamName": "Sales",
    "createdAt": "2026-04-17T10:00:00.000000Z",
    "updatedAt": "2026-04-17T10:00:00.000000Z",
    "currentTime": "2026-04-17T10:00:00+00:00"
  }
}