Skip to main content
View as Markdown

Groups

List and create the groups of an event. Groups split the people and exhibitors of an event so you can give them different rights, allow or block features, manage meeting rules, send them different emails or target different advertisements.

Reference: EventGroup object

Default groups​

Every event has three groups by default:

GroupWho is in it
AttendeesPeople who attend the event (guests, visitors, etc.).
ExhibitorsExhibitor companies and their members, usually company representatives who attend the event with a booth.
SpeakersPeople who speak at a session (planning in the API).

Some groups are assigned automatically:

  • When you add a person to an exhibitor as a member, they are added to the Exhibitors group.
  • When you add a person to a session as a speaker, they are added to the Speakers group.

You can create other groups in Swapcard Studio or with the Content API.

Group priority​

A person can be in several groups. An exhibitor can be in a single group, by default the Exhibitors group.

If a person is in several groups, directly or through an exhibitor they are a member of, only the group with the highest priority applies.

Before you begin​

  • An API key, sent in the Authorization header. The key acts with the roles and permissions of the user who created it. See Authentication.
  • The ID of your event (eventId). See Events.

List the groups of an event​

Use this query to fetch all the groups created on an event, with their priority and number of people.

ArgumentTypeDescription
eventIdID!The ID of the event.
Query
query EventGroupsByEventId($eventId: ID!) {
event(id: $eventId) {
groups {
id
name
peopleCount
priority
isDefault
}
}
}
Variables
{
"eventId": "RXZlbnDY1Nc4"
}

Create a group​

Use this mutation to create a group on an event, for example before you assign people to it with importEventPeople.

ArgumentTypeDescription
eventIdID!The ID of the event on which to create the group.
data.nameString!The name of the group.
Mutation
mutation CreateEventGroup($eventId: ID!, $data: CreateEventGroupInput!) {
createEventGroup(eventId: $eventId, data: $data) {
id
name
priority
}
}
Variables
{
"eventId": "RXZlbnDY1Nc4",
"data": {
"name": "NEWTESTGROUP1"
}
}