Exhibitors

An Exhibitor is a company participating in an event on Swapcard. Exhibitors can be booth holders, sponsors, partners, startups, etc.

Fields

The required field to create an Exhibitor is the name of Exhibitor.

Recommended fields are logoUrl, websiteUrl and description.

The categories field (table) displays one or several keywords on an exhibitor's profile, and allows users to filter based on these categories.

The type field (unique value) allows to sort by type (eg. Platinum, Gold, Silver). Within a type, exhibitors are listed alphabetically.

Object

• Exhibitor Object

Phone numbers format

The phone numbers should be specified according to the E.164 number formatting (http://en.wikipedia.org/wiki/E.164) recommendation and should be prefixed with a +. For example, to verify the US phone number 415 555 0101, the phone number should be specified as +14155550101. The + is the required prefix and the US country code 1 prepended to the local subscriber number.

Get the First hundred Exhibitors

This query can be used to fetch first 100 exhibitors from the event in Swapcard.

Arguments

• eventId - This is string value of the Event Id.

Query

query exhibitors($eventId: String!, $page: Int!) {
  exhibitors(eventId: $eventId, page: $page, pageSize: 100) {
    id
    name
    logoUrl
    websiteUrl
    description
  }
}

Variables

{
  "eventId": "RXZlbnRfMQ==",
  "page": 1
}

Get the Next hundred Exhibitors

This query can be used to fetch next hundred exhibitors from the event in Swapcard.

Query

query exhibitors($eventId: String!, $page: Int!) {
  exhibitors(eventId: $eventId, page: $page, pageSize: 100) {
    id
    name
    logoUrl
    websiteUrl
    description
  }
}

Variables

{
  "eventId": "RXZlbnRfMQ==",
  "page": 2
}

Get Exhibitors by Ids

This query can be used to fetch Exhibitors by Ids from the event in Swapcard.

Arguments

• eventId : The Id of the Event on which the search for Exhibitors needs to be done.
• ids: The Ids of Exhibitors that need to be searched. This is an array and can hold more than one value separated by commas.

Query

query exhibitors($eventId: String!, $ids: [String!]) {
  exhibitors(eventId: $eventId, ids: $ids, page:1, pageSize:100) {
    id
    name
    logoUrl
    websiteUrl
    description
  }
}

Variables

{
  "eventId": "RXZlbnRfMQ==",
  "ids": [
    "RXhoaWJzc5MDE3Mg==",
    "RXhoaWXzg4MTkyMA=="
  ]
}

Create Exhibitors

This mutation can be used to create Exhibitors in an Event in Swapcard.

Arguments

• eventId : The Id of the event on which the Exhibitor needs to be created/updated.
• exhibitors object : The data of the Exhibitors that need to be created in Swapcard. Minimum data required for each Exhibitor is name. We strongly recommend to use clientId for each Exhibitor, the clientId has to be a unique external id that never changes and can be used in the future to correctly identify and modify the Exhibitors data.

Query

mutation upsertMyExhibitors($eventId: String!, $exhibitors: [ExhibitorInput!]!) {
  upsertEventExhibitors(eventId: $eventId, exhibitors: $exhibitors) {
    id
    name
    logoUrl
    websiteUrl
    description
  }
}

Variables

{
  "eventId": "RXZlbnRfMQ==",
  "exhibitors": [
    {
      "name": "Test",
      "description": "This is a test Exhibitor.",
      "clientId": "Exhibitor12345"
    }
  ]
}

Update Exhibitors

This mutation can be used to update an already existing Exhibitor in an Event in Swapcard.

Arguments

• eventId : The Id of the Event on which the Exhibitor needs to be created/updated.
• exhibitors object : The data of the Exhibitors that needs to be created in Swapcard. Minimum data required for each Exhibitor is the name. In this example, we use the clientId to uniquely identify and update the name and description of the Exhibitor.

Query

mutation upsertExhibitors($eventId: String!, $exhibitors: [ExhibitorInput!]!) {
  upsertEventExhibitors(eventId: $eventId, exhibitors: $exhibitors) {
    id
    name
    logoUrl
    websiteUrl
    description
  }
}

Variables

{
  "eventId": "RXZlbnRfMQ==",
  "exhibitors": [
    {
      "name": "Test Exhibitor Update",
      "description": "This is an Updated test Exhibitor.",
      "clientId": "Exhibitor12345", 
      "categories": "Organizer",
      "logoUrl": "https://fakeimg.pl/250x100/",
      "websiteUrl": "https://test.com",
      "type": "Online Marketing "
    }
  ]
}

Update Exhibitors detailed

This mutation can be used to update an already existing Exhibitor in an Event in Swapcard.

Arguments

• eventId : The Id of the Event on which the Exhibitor needs to be created/updated.
• exhibitors object : The data of the Exhibitors that need to be created in Swapcard. Minimum data required for each Exhibitor is name.

In this example, we use the clientId to uniquely identify the Exhibitor and then link it with Exhibitor members, custom field, social network and documents. Custom field values should be created first using setSelectFieldValue, and then the key of the value should be sent in value along with the custom field id in definitionId.

Query

mutation upsertMyExhibitors($eventId: String!, $exhibitors: [ExhibitorInput!]!) {
  upsertEventExhibitors(eventId: $eventId, exhibitors: $exhibitors) {
    id
    name
    logoUrl
    websiteUrl
    description
  }
}

Variables

{
  "eventId": "RXZlbnRfMQ==",
  "exhibitors": [
    {
     "name": "Test Exhibitor Update",
      "description": "This is an Updated test Exhibitor.",
      "clientId": "Exhibitor12345", 
      "categories": "Organizer",
      "booths": [{ "name" :"test booth", "id":"12987" }],
      "logoUrl": "https://fakeimg.pl/250x100/",
      "websiteUrl": "https://test.com",
      "type": "Online Marketing ",
      "socialNetworks": [{ "profile": "test_twitter exhibitor", "type": "TWITTER"}],
      "createFields" : [{definitionId: "RmllbGREZWZpbml0aW9uXzQ2NjEzNA==", value: "france"}, {definitionId: "RmllbGREZWZpbml0aW9uXzQ2NjEzNw==", value: "hall-1"}, {definitionId: "RmllbGREZWZpbml0aW9uXzQ2NjEzOA==", value: "world-food"}, {definitionId: "RmllbGREZWZpbml0aW9uXzQ2NjEzOQ==", value: "tea"}, {definitionId: "RmllbGREZWZpbml0aW9uXzQ2NjEzOQ==", value: "ice-cream"}],
      "membersIds": ["RXZlbnRQZW9wbGVfMTI3OTEyMTQ="],
      "documents": [
        {
          "url":"https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
          "name" :"test2"
        }
      ]
    }
  ]
}

Update Exhibitors using updateExhibitor mutation

This mutation can be used to update an existing Exhibitor in an Event on Swapcard. The updateExhibitor mutation is different than the upsertExhibitors mutation as it can be used for some special features/rights and advanced fields.

Arguments

• eventId : The Id of the Event on which the Exhibitor needs to be updated.
• exhibitorId : The swapcard Internal Id of the Exhibitor that needs to be updated.

In this example, we use the exhibitorId to uniquely identify and update the name, description and add other details like group id, background image, website URL and logo of the Exhibitor. We can also link Products to Exhibitor using this mutation.

Query

mutation updateExhibitor($input: UpdateExhibitorInput!) {
  updateExhibitor(input: $input) {
    errors {
      code
      input
    }
    exhibitor {
      clientIds
      createdAt
      id
    }
  }
}

Variables

{
  "input" : {
    "eventId":"RXZlbnRfMQ==",
    "groupId": "RXZlbnRI=",
    "exhibitorId": "RXhoaWJpdG9yXzcxMjQ5NA==",
    "name":"Updated Exhibitor with Products",
    "logoUrl":"www.testExhibitor.png",
    "websiteUrl":"www.testExhibitor.com" ,
    "backgroundImageUrl": "www.exhibitorbackgroundimage.png",
    "productIds": ["UHJvZHVjdF82MTQwMjc=","UHJvZHVjdF97MTQwMjc=" ],
    "description": "This is a new updated Exhibitor with products linked to it",
    "features": {
    "canExportAdvertisements": true, 
    "canExportChats": true,  
    "canExportContacts": true, 
    "canExportDocuments": false, 
    "canExportExhibitorPages": false, 
    "canExportExhibitorItems": false, 
    "canExportMeetingsConfirmed": true, 
    "canExportRegistrations": false, 
    "canExportWatchedExhibitorPlannings": false, 
    "canViewVisits": true, 
    "inviteMembers": true,  
    "scanBadge": true
  }
  }
}

Link Two Exhibitors mutation

These mutations can be used to link an already existing Exhibitor to another Exhibitor in an Event in Swapcard.

Step 1: We create a link between the two Exhibitors. This link defines the relation between the two Exhibitors.

Query

mutation CreateExhibitorLink($input: CreateExhibitorLinkInput!) {
  createExhibitorLink(input: $input) {
    exhibitorLink {
      childName
      id
      parentName
    }
  }
}

Variables

{
  "input": {
 "eventId": "RXZlbnRfMQ==",
 "parentName": "Parent Exhibitor", 
 "childName": "Child Exhibitor"
  }   
  }

Step 2 When we create the link in the above mutation, in the response we get an exhibitorLink Id. Now we use this ID to create a direct link on the UI between the two Exhibitors.

Query

mutation CreateExhibitorLinkRelation($input: CreateExhibitorLinkRelationInput!) {
  createExhibitorLinkRelation(input: $input) {
    exhibitorLink {
      childName
      id
      parentName
    }
  }
}

Variables

{
  "input": {
 "exhibitorLinkId": "RXhoaWJpGlua18xMDAx",
 "parentExhibitorId": "RXhoaWJpzc5MDE3Mg==", 
 "childExhibitorId": "RXhoaWJp4MTkyMA=="
}
}

Delete Exhibitor

This mutation can be used to delete an Exhibitor in an Event in Swapcard.

Arguments

• eventId : The Id of the Event on which the Exhibitor needs to be deleted.

• exhibitorIds: The Ids of Exhibitors that need to be deleted. This is an array and can hold more than one value separated by commas.

Query

mutation deleteExhibitors($eventId: String!, $exhibitorIds: [String!]!) {
  deleteEventExhibitors(eventId: $eventId, exhibitorsIds: $exhibitorIds) {
    id
    name
    logoUrl
    websiteUrl
    description
  }
}

Variables

{
 "eventId": "RXZlbnRfMQ==",  
  "exhibitorIds": [
   "RXhoaWJpdG9yXzI=","RXhoaWJpdG7pXzI="
  ]
}