Skip to main content

Common Parameters

These parameters appear in multiple tools:

swoogo_fields_get

List the field definitions Swoogo stores for an object type: attribute name, label, input type, and the choice IDs for dropdown, radio and checkbox fields. Schemas are account-level; omit event_id. Call this before any create or update tool that takes custom fields or ID-valued fields. For example: { object: "sponsor" } returns level IDs that swoogo_create_sponsor accepts. { object: "contact" } returns contact fields that swoogo_contacts_save accepts.

Parameters

See Common Parameters for page, per_page, sort.

Object values

There is no speaker or registrant value. For an event’s registration questions, use swoogo_get_registration_form. With field_id, object is still required. The call returns that one field with its full choice list. A missing or invalid object returns an error that lists the four values.

Example prompts

  • “What are the level IDs for sponsors?”
  • “List the custom fields on contacts”

swoogo_audits_get

Audit session bookings or registration status changes for an event’s registrants in a time window.

Parameters

Example prompts

  • “What session changes happened for event 12345 since 2026-09-01?”
  • “Show registration status changes for this event in the last week”

swoogo_cfs_get

Query call-for-speakers records for an event: submissions, reviews, or the submitters and reviewers with their CFS roles.

Parameters

See Common Parameters for name, page, per_page, sort.

Example prompts

  • “List all speaker submissions for event 12345”
  • “Show the reviews for the submission titled ‘AI in Healthcare’”
  • “Show review 789”

swoogo_invitation-lists_get

List or retrieve invitation lists for an event, or the contacts on a specific list.

Parameters

See Common Parameters for name, page, per_page, sort.

Example prompts

  • “List the invitation lists for event 12345”
  • “Who’s on invitation list 456?“

swoogo_invitation-lists_create

Create an invitation list for an event, and add contacts to it in the same call. Contacts on a list can register for the event.

Parameters

A contact can be on only one list per event. Adding a contact to a list removes it from the other lists of the same event.

Example prompts

  • “Create a VIP guests invitation list for event 12345 with contacts 1, 2, and 3”

swoogo_invitation-lists_update

Rename an invitation list, change its notes, or add more contacts. Only the fields you provide are changed. Contacts already on the list stay on it.

Parameters

Example prompts

  • “Add contact 7 to invitation list 456”
  • “Rename invitation list 456 to Speakers and guests”