createAttendee

Source:

Published:

Keywords: createAttendee, GraphQL Mutation, AttendeeParams

Document ID: https://touchpoint-support.certain.com/hc/en-us/articles/360033729633-createAttendee#split1

Arguments

gatheringId: (Int!)

gatheringId is a required argument.

attendee: (AttendeeParams) [see below for full params]

attendee is an AttendeeParams object.

GraphQL Mutation

mutation {
  createAttendee(attendee: { firstName: "David Foster", lastName: "Wallace" }, gatheringId: 232) {
    firstName
    lastName
    id
  }
}

CURL Request

curl -X POST https://api.certaintouchpoint.com/graphql -H 'Content-Type: application/graphql' -H 'Authorization: Bearer 123abcveryLongAuthorizationToken456def' -d '{ mutation { createAttendee(attendee: { firstName: "David Foster", lastName: "Wallace"}, gatheringId: 232) { firstName lastName id } }'

GraphQL Response

{“data”:
{ "createAttendee":
{ "lastName":"Wallace",
"id":"71111",
"firstName":"David Foster"
}}

AttendeeParams

When creating an attendee firstName and lastName are required.

Required fields

Optional fields

Providing a Photo/Avatar

You may supply an attendee photo in several ways. Using the photoUrl attribute, you may supply a URL. Using the photo attribute you may supply either a Base64 encoded string or an image file using the multipart/form-data content type. An image file is preferred to the Base64 string as it will be smaller.

photoUrl (String)

If the photo resides at a publicly available URL, you may provide that URL here (.jpg or.png format). The image at that URL will be copied into the Touchpoint system.

photo (DataUpload)

Choose multipart file (preferred) and Base64:

Provide the photo as a file

Use the multipart/form-data content type.

Example:

curl -X POST https://api.certaintouchpoint.com/graphql -H 'Content-Type: application/graphql' -H 'Authorization: Bearer 123abcveryLongAuthorizationToken456def' -F query='mutation { createAttendee(attendee: { firstName: "David Foster", lastName: "Wallace", photo: "photo_argument"}, gatheringId: 232) { firstName lastName id }' -F photo_argument=@photo.jpg

Notice that the value of the photo attribute is the name of the argument used to refer to the photo file.

Provide the photo file as a Base64 encoded string

Prefix the photo string with the information:

data:<mime type>;base64,<encoded data>

Example:

curl -X POST https://api.certaintouchpoint.com/graphql -H 'Content-Type: application/graphql' -H 'Authorization: Bearer 123abcveryLongAuthorizationToken456def' -d '{ mutation { createAttendee(attendee: { firstName: "David Foster", lastName: "Wallace", photo: "data:image/jpg;base64,alongbase64encodedstring"}, gatheringId: 232) { firstName lastName id } }'

Retrieving Relationships

assignedAgendaSessions (String)

Agenda Sessions that have been preregistered for the Attendee.

bookmarksAgendaSessions (String)

Agenda Sessions that have been selected by the Attendee.

checkedInAgendaSessions (String)

Agenda Sessions that the Attendee has checked into.

Creating Relationships

assignedAgendaSessionIds (Array of Ids)

The unqiue ID of the attendee from it\'s source (i.e., the attendee id in your system). Not displayed.