createCompetitorMeeting

Overview

In a Comptetitive meeting, you will identify which participants are the "neutral party." Participants who are not neutral will not be visible on the participant list. Additionally, the title of the meeting will be automatically generated for each participant. As above, the name of the meeting may be customized for each participant in the Custom Meeting Name field.

Arguments

• gatheringId: (Int!)
• meeting: (CompetitorMeetingParams)

GraphQL Mutation

mutation {
  createCompetitorMeeting(gatheringId:232, meeting: {
    name:"BetaGroup Company Presentation" startsAt:"2018-07-22T20:35:09Z"
    endsAt: "2018-07-28T20:35:09Z"
    surveys: [{externalId:"meeting_survey"}]
    participants: [
      { participantKind: "attendee", participantId: 2771895, roleLabel: "Investor" }
      { participantKind: "attendee", participantId: 208711, neutralParty: true, customMeetingName: "Meeting with BetaGroup" }
    ]}
  ) {
    name
    description
    startsAt
    endsAt
    externalId
    externalSource
    participants {
      customMeetingName
      neutralParty
      participantId
      participantKind
      roleLabel
    }
  }
}

CURL Request

curl -X POST https://api.certaintouchpoint.com/graphql -H 'Content-Type: application/graphql' -H 'Authorization: Bearer 123abcveryLongAuthorizationToken456def' -d '{ mutation { createCompetitorMeeting(meeting: { name:"BetaGroup Company Presentation" startsAt:"2018-07-22T20:35:09Z" endsAt: "2018-07-28T20:35:09Z" surveys: [{externalId:"meeting_survey"}] participants: [{ participantKind: "attendee", participantId: 2771895, roleLabel: "Investor" } { participantKind: "attendee", participantId: 208711, neutralParty: true, customMeetingName: "Meeting with BetaGroup" }]}, gatheringId: 232) { name description startsAt endsAt externalId externalSource participants { customMeetingName neutralParty participantId participantKind roleLabel } }'

GraphQL Response

{
  "data": {
    "createCompetitorMeeting": {
      "startsAt": "2018-07-22T20:35:09Z",
      "participants": [
        {
          "roleLabel": null,
          "participantKind": "attendee",
          "participantId": 211374,
          "neutralParty": true,
          "customMeetingName": null
        },
        {
          "roleLabel": "Investor",
          "participantKind": "attendee",
          "participantId": 211374,
          "neutralParty": null,
          "customMeetingName": null
        }
      ],
      "name": "BetaGroup Company Presentation10",
      "externalSource": null,
      "externalId": null,
      "endsAt": "2018-07-28T20:35:09Z",
      "description": ""
    }
  }
}

CompetitorMeetingParams

When creating a competitor meeting, the following fields are required:

• name (String!) required The name of the meeting as it will appear in the CMS. The display name of the meeting on a participant's agenda will be automatically determined.
• startsAt (Datetime) The start date and time of the meeting in UTC.
• endsAt (Datetime) The end date and time of the meeting in UTC.
• description (String) Text description of the meeting. No character limit.

Creating Relationships

To set participants, use the participants parameter (CompetitorMeetingParticipantParams). The CompetitorMeetingParticipantParams are described below.

To set a location, use the location parameter (LocationParams). The LocationParams consists of a name for the location.

To set a survey, use the surveys parameter (SurveyParams). The Survey consists of an externalId for the survey.

CompetitorMeetingParticipantParams

• participantId (Int!) required Certain Touchpoint-assigned id of the meeting participant.
• participantKind (String!) The kind of participant, (i.e., attendee, exhibitor, speaker).
• neutralParty (Boolean) The end date and time of the meeting in UTC.
• roleLabel (String) This is a cosmetic label to describe a role in the meeting (e.g., moderator, etc.).