Skip to main content
All five tools act as the signed-in user and work within one organization — the one resolved automatically, or the one chosen with select_organization.

list_events

Lists your organization’s events, newest first. Returns each event’s id, name, dates, locations, numPeople, status and createdAt, plus page, limit and total.

get_event

Gets a single event’s detail by its id. Returns the list_events fields plus venueType, numHotelRoomsNeeded, isMultiDay, otherNotes and currency. An id that does not exist, and one belonging to another organization, both return the same not-found error — you never learn whether another organization’s event exists.

create_event

Creates a new event in your organization. You become its owner. Returns the new event’s id and grantedTo — how many people can now see it.
A grantedTo of 0 means the event was created but is not yet visible to anyone — see Writing events for why and what to do.

update_event

Changes an event’s planning details — dates, headcount, budget, guestrooms, agenda and notes.
Call get_event first so you are editing current values. The write rules — omitted-versus-null, all-or-nothing, agenda-by-operation, and the two refusals you can hit — are covered in Writing events.

select_organization

Only needed if your account belongs to more than one organization. Call it once to choose which organization the event tools work in; the choice is remembered for this client until you change it. If you belong to a single organization, this tool is unnecessary — the other tools resolve it automatically.