createAgendaSession

This article documents how to create an agenda session in Touchpoint using a GraphQL mutation, including required arguments, example requests, and parameter definitions.

Arguments

• gatheringId is an Int and is required.
• agendaSession is an AgendaSessionParams.

GraphQL Mutation

mutation {
  createAgendaSession(agendaSession: {name: "New Training Session", startsAt: :"2018-10-20T01:00:00Z", endsAt:"2018-10-20T02:00:00Z"}, gatheringId: 232) {
    name
    startsAt
    id
  }
}

CURL Request

curl -X POST https://api.certaintouchpoint.com/graphql \
-H 'Content-Type: application/graphql' \
-H 'Authorization: Bearer 123abcveryLongAuthorizationToken456def' \
-d '{ mutation { createAgendaSession(agendaSession: { name: "New Training Session", startsAt: :"2018-10-20T01:00:00Z", endsAt:"2018-10-20T02:00:00Z"}, gatheringId: 232) { name startsAt id } }'

GraphQL Response

{
  "data": {
    "createAgendaSession": {
      "name": "New Training Session",
      "startsAt": "2018-10-20T01:00:00Z",
      "id": "71111"
    }
  }
}

AgendaSessionParams

When creating an agenda session, name and startsAt are required.

• id is a String. Touchpoint assigned id of the agenda session.
• name is a String. The name of the agenda session as it appears on the public agenda.
• description is a String. Text description of the event. No character limit.
• startsAt is a Datetime. The start date and time of the agenda session in UTC.
• endsAt is a Datetime. The end date and time of the agenda session in UTC.
• parentAgendaSessionId is an Id. For sub-sessions, this is the id of the parent session.
• externalId is a String. The unique ID of the agenda session from its source (i.e., the agenda session id in your system). Not displayed.
• externalSource is a String. External data source of the agenda session. If you have created this agenda session in the Touchpoint system, Touchpoint will define the externalSource. Not displayed.
• generateCheckInCode is a String. If true, Touchpoint will set the checkInType to "code" for this agenda session and generate a code automatically.
• checkInCode is a String. If the checkInType includes "code", this is the relevant code.
• checkInType is a String. Current options: unverified, scan, code, time_bounded, code_and_time_bounded, none.
• timeZone is a String. Typically the gathering is the source of the time zone, but if the agenda session has a different time zone, include it here.
• speakers is a [SpeakerParams]. Speaker id. Note that Speaker params are structured [{ id: 23213 }]

Was this article helpful? [Yes] [No]

Related articles

• updateAgendaSession
• Agenda Sessions Query
• Overview - Touchpoint API
• Gatherings Query
• createAttendee

[END MARKDOWN]