Skip to content

Create an event

Request

Creates an event: a calendar entry for a staff member that is not tied to a service. It takes a smaller payload than a booking, and the response is the same booking object with type set to EVENT and service_id, cost and label empty.

Security
BearerAuth
Bodyapplication/jsonrequired
idstring

Ignored when creating an event. The event id is generated.

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.

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(BookingLocationRequest)

Video meeting for the event. Providing the provider type is enough, and the link is generated for you.

sourcestring, <= 100 characters

Origin of the event (e.g. integration name).

Example:"booking_page"
curl -i -X POST \
  https://developer.setmore.com/api/v2/bookings/events \
  -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"
        }
      ]
    },
    "source": "booking_page"
  }'

Responses

Event created.

Bodyapplication/json
dataobject(Booking)

A booking, as returned in API responses.

Response
{ "data": { "id": "bk_123456", "type": "EVENT", "calendar_id": "acc_123456", "account_id": "acc_123456", "provider_id": "provider_123456", "consumer_ids": [ … ], "title": "Team lunch", "start_at": "2026-01-20T09:00:00Z", "end_at": "2026-01-20T10:00:00Z", "status": "CONFIRMED" } }