v1

latestOpenAPI 3.1.0Proprietary2026-07-24660315.0 KB

Events

Update Guest Status

Update a guest’s status. Set status to approved ("Going"), declined, pending_approval, or waitlist. Use should_refund to refund a paid guest when moving them out of an approved state. Use message to include a personal note in the email we send the guest. To send a soft invite that guests can accept, use /v1/events/guests/send-invites instead.

post/v1/events/guests/update-status

Request body

event_idstring required

Event ID, this usually starts with evt-

guest_idstring required

Guest identifier — the guest ID (gst-), a ticket key, a guest key (g-), or the user's email.

status'approved' | 'declined' | 'pending_approval' | 'waitlist' required

should_refundboolean

If you are moving a guest who has paid to declined, waitlist, or pending_approval, should we refund their payment? Defaults to false.

send_emailboolean nullable

Optional. Whether Luma should email the guest about the status change. Defaults to true. Set to false if your integration sends its own notifications.

messagestring nullable

Optional. Personal message included in the email we send the guest about the status change. Max of 200 characters. Can't be combined with send_email: false.

Response

Successful response.

object required

Empty response