Skip to content

Update an event

Request

Updates the event identified by the id in the path. If the request body also contains an id, it must match the path id; otherwise the request is rejected with 400 (parameter_invalid, "Invalid id"). Only events can be updated here. To update an appointment or a class session, use Update a booking.

An update does not change the event's created_at. If source is left out, the stored source is kept.

Video meeting (location):

  • Keep the existing meeting unchanged: send the event's existing location back as it was returned (type, and video_type with its id, link and type), or leave location out.
  • Remove the meeting: send an empty object, "location": {}.
  • Generate a new meeting: send location with type: ["videoType"] and video_type: [{ "type": "google-meet" }]. Providing the provider type is enough, and the link is generated.
Security
BearerAuth
Path
idstringrequired
Example:bk_123456
Bodyapplication/jsonrequired
idstring

Event id. Optional on update; when sent it must equal the {id} path parameter, otherwise the request is rejected with 400 (parameter_invalid, "Invalid id").

Example:"bk_123456"
typestringrequired

Always EVENT.

Value:"EVENT"
Example:"EVENT"
account_idstringrequired

Setmore account id that owns this event.

Example:"acc_123456"
provider_idstring, <= 100 charactersrequired

Id of the staff member the event is for.

Example:"provider_123456"
consumer_idsArray of strings, <= 10 items

Ids of the customers attending the event, up to 10. Optional, leave it out to keep the current customers.

Example:
[ "cust_123456" ]
start_atstring, (date-time)required

Start date/time, an RFC 3339 date-time with an offset: Z for UTC or a numeric offset such as +08:00, in whole seconds. For example, 2026-11-19T08:30:00+08:00 and 2026-11-19T00:30:00Z are the same moment. It is returned in UTC.

Example:"2026-11-19T08:30:00+08:00"
end_atstring, (date-time)required

End date/time, an RFC 3339 date-time with an offset: Z for UTC or a numeric offset such as +08:00, in whole seconds. For example, 2026-11-19T09:00:00+08:00 and 2026-11-19T01:00:00Z are the same moment. It is returned in UTC.

Example:"2026-11-19T09:00:00+08:00"
titlestring, [ 1 .. 255 ] characters\Srequired

Required. Must contain at least one non-whitespace character; an empty or blank title is rejected with parameter_not_found.

Example:"Team lunch"
notesstring, <= 1500 characters
Example:"Book a table for six."
locationobject(BookingLocationUpdateRequest)

Video meeting for the event. See the table for what to send to keep, remove or generate a meeting.

sourcestring, <= 100 characters

Origin of the event (e.g. integration name). Optional on update; leave it out to keep the stored value.

Example:"booking_page"
curl -i -X PUT \
  https://developer.setmore.com/api/v2/bookings/events/bk_123456 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "bk_123456",
    "type": "EVENT",
    "account_id": "acc_123456",
    "provider_id": "provider_123456",
    "consumer_ids": [
      "cust_123456"
    ],
    "start_at": "2026-11-19T08:30:00+08:00",
    "end_at": "2026-11-19T09:00:00+08:00",
    "title": "Team lunch",
    "notes": "Book a table for six.",
    "location": {
      "type": [
        "videoType"
      ],
      "video_type": [
        {
          "type": "google-meet",
          "id": "vid_123456",
          "link": "https://meet.google.com/abc-defg-hij"
        }
      ]
    },
    "source": "booking_page"
  }'

Responses

Event updated.

Bodyapplication/json
dataobject(Booking)

A booking, as returned in API responses.

Response
{ "data": { "id": "bk_123456", "type": "APPOINTMENT", "calendar_id": "cal_123456", "account_id": "acc_123456", "provider_id": "provider_123456", "consumer_ids": [ … ], "service_id": "svc_123456", "start_at": "2026-01-20T09:00:00Z", "end_at": "2026-01-20T10:00:00Z", "booking_id": "ext_bk_654321", "cost": 50, "title": "Consultation", "notes": "Customer requested a reminder call the day before.", "status": "CONFIRMED", "label": "RUNNING_LATE", "location": { … }, "created_at": "2026-01-15T12:00:00Z", "source": "booking_page", "meta_data": { … } } }