Proposals/Confirmed Bookings

Assign a staff member to an event

Assigns a staff member to an event (booking or proposal). The staff member must belong to the same franchise. Use the role field to label what the staff member is doing on the event (e.g., "DJ", "Photographer", "Assistant"). The same user can be assigned to the same event multiple times with different roles.

By default the staff member is assigned to the whole event (every package). To scope the assignment to specific packages, send all_event_bookings: false together with event_booking_ids listing the packages (EventBooking IDs) they cover; ids that don't belong to this event are ignored. Arrival time is per-package: set arrival times via event_booking_arrives_at_times, an object keyed by EventBooking ID (e.g. { "123": "5:30 PM" }). An all-packages member may set per-package arrivals too.

For confirmed bookings, assigning a staff member also applies any configured staff expenses, sends the "Employee Assigned" automated message, dispatches push notifications, and fires the staff-assigned webhook. None of these side effects run for proposals.

Required permission: assigned_event_write or unassigned_event_write

post/api/v1/events/{event_id}/event_staff_members

Request

  • Base URL: https://api.checkcherry.com
  • URL: https://api.checkcherry.com/api/v1/events/{event_id}/event_staff_members
  • Auth: none declared. Required headers: Api-Key

Path parameters

event_idinteger required

The ID of the event to assign the staff member to

Headers

Api-Keystring required

Your Integration Key

Request body

staff_idinteger required

The ID of the staff user to assign

rolestring

The role this staff member will fill on the event (e.g., "DJ", "Photographer")

all_event_bookingsboolean

Assign to every package on the event (default true). Send false with event_booking_ids to scope to specific packages.

event_booking_idsinteger[]

When all_event_bookings is false, the EventBooking (package) IDs this staff member covers.

event_booking_arrives_at_timesobject

Optional per-package arrival times, keyed by EventBooking ID, e.g. { "123": "5:30 PM" }.

Response

staff member assigned to specific packages

Changes

No recorded changes to this operation across all 2 revisions of this API.