Speakers Query

Arguments

• gatheringId is an Int.
• filters is a Filter.
• createdAfter is a Date. Returns resources created at or after the specified datetime (inclusive). Datetime must be in ISO 8601 format.
• createdBefore is a Date. Returns resources created at or before the specified datetime (inclusive). Datetime must be in ISO 8601 format.
• updatedAfter is a Date. Returns resources updated at or after the specified datetime (inclusive). Datetime must be in ISO 8601 format.
• updatedBefore is a Date. Returns resources updated at or before the specified datetime (inclusive). Datetime must be in ISO 8601 format.

CURL Request

curl -X POST https://api.certaintouchpoint.com/graphql -H 'Content-Type: application/graphql' -H 'Authorization: Bearer 123abcveryLongAuthorizationToken456def' -d '{speakers(gatheringId: 232) {firstName lastName}}'

This query will return the lastName, id, and externalId for each speaker.

Query Example

{
  speakers(gatheringId: 4422) {
    firstName
    lastName
    id
    externalId
    createdAt
    updatedAt
  }
}

CURL Request

curl -X POST https://api.certaintouchpoint.com/graphql -H 'Content-Type: application/graphql' -H 'Authorization: Bearer 123abcveryLongAuthorizationToken456def' -d '{ speakers(gatheringId: 232) { firstName lastName id externalId bookmarkedAgendaSessions { name startsAt endsAt id externalId } surveyResponses {id answers { id question { id name questionData questionType} answer }}}}'

SpeakerParams

Attributes

• firstName is a String. Speaker first name. Displayed if present.
• lastName is a String. Speaker last name. Displayed if present.
• prefix_name is a String. Speaker honorific (Mr., Ms., Dr.). Displayed if present.
• suffix_name is a String. Speaker suffix (Jr., Sr., Md., Phd). Displayed if present.
• kind is a String. Speaker kind (Keynote, Workshop). Displayed if present.
• login_email is a String. Email used to login. Not displayed.
• organization is a String. Speaker organization or company. Displayed if present.
• job_title is a String. Speaker organization or company. Displayed if present.
• email is a String. Speaker email. Displayed if present. Not related to the login email.
• fax is a String. Speaker fax. Displayed if present.
• telephone is a String. Speaker preferred telephone number. Displayed if present.
• website is a String. Speaker URL. Displayed if present.
• twitterHandle is a String. Speaker Twitter handle. @ is optional. Displayed if present.
• facebookUsername is a String. Speaker Facebook username. Not a URL. Displayed if present.
• linkedInUrl is a String. Speaker LinkedIn URL. Displayed if present.
• street is a String. Speaker Street (3722 Maplehurst Drive). Displayed if present.
• street2 is a String. Speaker Street - supplemental (e.g., Suite 181). Displayed if present.
• city is a String. Speaker last name. Displayed if present.
• state is a String. Speaker's state or province. Displayed if present.
• postalCode is a String. Speaker's Postal or ZIP code. Displayed if present.
• country is a String. Speaker's country. Displayed if present.
• biography is a String. Speaker biography in HTML format. Distinct from BiographyText. Displayed if present. Not editable by speaker.
• hidden is a Boolean. If this boolean is set to true, this speaker will not be visible in the mobile app and cannot participate socially.
• externalId is a String. The unique ID of the speaker from its source (i.e., the speaker id in your system). Not displayed.
• externalSource is a String. External data source of the speaker. If you have created this speaker in the Touchpoint system, Touchpoint will define the externalSource. Not displayed.
• createdAt is a Date. Timestamp indicating when the resource was created. Returned in ISO 8601 UTC format.
• updatedAt is a Date. Timestamp indicating when the resource was last updated. Returned in ISO 8601 UTC format.

Providing a Photo/Avatar

• photoUrl is a 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 is a DataUpload. Choose multipart file (preferred) and Base64.

To provide the photo as a file

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

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

To provide the photo file as a Base64 encoded string

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

To provide the photo file as a Base64 encoded string, prefix the photo string with the information:

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

For example:

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

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

Providing the photo file as a Base64 encoded string, prefix the photo string with the Information:

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

Was this article helpful?

• Yes
• No

Related articles

• Overview - Touchpoint API
• Agenda Sessions Query
• Speakers Feature
• In-App Links
• createSpeaker

Comments

• 0 comments
• Please sign in to leave a comment.