Create Gathering

The article demonstrates how to create a gathering using GraphQL in the Touchpoint API.
This page shows the required arguments and example requests and responses.

Arguments

appId: (Int!) — The application identifier.
gathering: (GatheringParams)

GraphQL Mutation

mutation {
  createGathering(gathering: {name: "Great Event", startsOn: "2018-01-23", endsOn: "2018-01-25", timeZone: "Eastern Time (U.S. & Canada)" }, appId: 232) {
    name
    StartsOn
    EndsOn
    id
  }
}

CURL Request

curl -X POST https://api.certaintouchpoint.com/graphql -H 'Content-Type: application/graphql' -H 'Authorization: Bearer 123abcveryLongAuthorizationToken456def' -d '{ mutation { createGathering(gathering: { name: "Great Event", startsOn: "2018-01-23", endsOn: "2018-01-25", timeZone: "Eastern Time (U.S. & Canada)"}, appId: 232) { name id startsOn endsOn } }'

GraphQL Response

{"data":
{ "createGathering":
{ "name":"Great Event",
"id":"71112",
"startsOn":"2018-01-23",
"endsOn":"2018-01-25"
}
}
}

GatheringParams

GatheringParams is the set of fields used to define a gathering. The following fields are described.

name (String): The name of the gathering as it appears on the public listing.
startsOn (Date): The start date of the gathering in UTC.
endsOn (Date): The end date of the gathering in UTC.
timeZone (String): The time_zone of the gathering.
externalId (String): The unique ID of the gathering from the source. Not displayed.
externalSource (String): External data source of the gathering. If you have created this gathering in the Touchpoint system, Touchpoint will define the external_source. Not displayed.

Was this article helpful? 0 out of 0 found this helpful

Have more questions? Submit a request

Attendees Query
Gatherings Query
Overview - Touchpoint API
createAttendee

```