Mutation
mutation CreateTagMemberships($input: CreateTagMembershipsInput!) {
createTagMemberships(input: $input) {
clientMutationId
errors
grantedMembers {
ambassadorLevel
ambassadorLevelId
avatarUrl
badges {
avatarUrl
color
createdAt
creator {
__typename
}
customField {
__typename
}
description
}
conversations {
edges {
__typename
}
nodes {
__typename
}
pageInfo {
__typename
}
}
customFieldResponses {
edges {
__typename
}
nodes {
__typename
}
pageInfo {
__typename
}
}
}
outcome
tag {
color
createdAt
creator {
ambassadorLevel
ambassadorLevelId
avatarUrl
badges {
__typename
}
conversations {
__typename
}
customFieldResponses {
__typename
}
}
customField {
allowAdHoc
answers {
__typename
}
createdAt
description
id
maxCharacters
}
description
id
}
}
}Variables
{
"input": {
"memberIds": [
"id"
],
"tagId": "id"
}
}Response
{
"data": {
"createTagMemberships": {
"clientMutationId": "string",
"errors": [
"string"
],
"grantedMembers": [
{
"ambassadorLevel": "string",
"ambassadorLevelId": 1,
"avatarUrl": "string",
"badges": [
{
"avatarUrl": "string",
"color": "string",
"createdAt": "value",
"creator": {
"__typename": "Member"
},
"customField": {
"__typename": "CustomField"
},
"description": "string"
}
],
"conversations": {
"edges": [
{
"__typename": "PublicConversationEdge"
}
],
"nodes": [
{
"__typename": "PublicConversation"
}
],
"pageInfo": {
"__typename": "PublicConversationPageInfo"
}
},
"customFieldResponses": {
"edges": [
{
"__typename": "MemberCustomFieldResponseEdge"
}
],
"nodes": [
{
"__typename": "MemberCustomFieldResponse"
}
],
"pageInfo": {
"__typename": "PageInfo"
}
}
}
],
"outcome": "ALREADY_GRANTED",
"tag": {
"color": "string",
"createdAt": "value",
"creator": {
"ambassadorLevel": "string",
"ambassadorLevelId": 1,
"avatarUrl": "string",
"badges": [
{
"__typename": "Badge"
}
],
"conversations": {
"__typename": "PublicConversationConnection"
},
"customFieldResponses": {
"__typename": "MemberCustomFieldResponseConnection"
}
},
"customField": {
"allowAdHoc": true,
"answers": {
"__typename": "CustomFieldAnswerConnection"
},
"createdAt": "value",
"description": "string",
"id": "id",
"maxCharacters": 1
},
"description": "string",
"id": "id"
}
}
}
}Mutations
createTagMemberships
Assign a tag to members. Pass the tag ID and the member IDs to grant it to.
Required scope: host:write:network_members
MUTATION
createTagMemberships(input: CreateTagMembershipsInput!): CreateTagMembershipsPayloadArguments
input
required
Parameters for CreateTagMemberships
Returns
clientMutationId
String
A unique identifier for the client performing the mutation.
errors
[String!]!
grantedMembers
[Member!]!
The members newly granted the tag — excludes any who already had it.
outcome
tag
Mutation
mutation CreateTagMemberships($input: CreateTagMembershipsInput!) {
createTagMemberships(input: $input) {
clientMutationId
errors
grantedMembers {
ambassadorLevel
ambassadorLevelId
avatarUrl
badges {
avatarUrl
color
createdAt
creator {
__typename
}
customField {
__typename
}
description
}
conversations {
edges {
__typename
}
nodes {
__typename
}
pageInfo {
__typename
}
}
customFieldResponses {
edges {
__typename
}
nodes {
__typename
}
pageInfo {
__typename
}
}
}
outcome
tag {
color
createdAt
creator {
ambassadorLevel
ambassadorLevelId
avatarUrl
badges {
__typename
}
conversations {
__typename
}
customFieldResponses {
__typename
}
}
customField {
allowAdHoc
answers {
__typename
}
createdAt
description
id
maxCharacters
}
description
id
}
}
}Variables
{
"input": {
"memberIds": [
"id"
],
"tagId": "id"
}
}Response
{
"data": {
"createTagMemberships": {
"clientMutationId": "string",
"errors": [
"string"
],
"grantedMembers": [
{
"ambassadorLevel": "string",
"ambassadorLevelId": 1,
"avatarUrl": "string",
"badges": [
{
"avatarUrl": "string",
"color": "string",
"createdAt": "value",
"creator": {
"__typename": "Member"
},
"customField": {
"__typename": "CustomField"
},
"description": "string"
}
],
"conversations": {
"edges": [
{
"__typename": "PublicConversationEdge"
}
],
"nodes": [
{
"__typename": "PublicConversation"
}
],
"pageInfo": {
"__typename": "PublicConversationPageInfo"
}
},
"customFieldResponses": {
"edges": [
{
"__typename": "MemberCustomFieldResponseEdge"
}
],
"nodes": [
{
"__typename": "MemberCustomFieldResponse"
}
],
"pageInfo": {
"__typename": "PageInfo"
}
}
}
],
"outcome": "ALREADY_GRANTED",
"tag": {
"color": "string",
"createdAt": "value",
"creator": {
"ambassadorLevel": "string",
"ambassadorLevelId": 1,
"avatarUrl": "string",
"badges": [
{
"__typename": "Badge"
}
],
"conversations": {
"__typename": "PublicConversationConnection"
},
"customFieldResponses": {
"__typename": "MemberCustomFieldResponseConnection"
}
},
"customField": {
"allowAdHoc": true,
"answers": {
"__typename": "CustomFieldAnswerConnection"
},
"createdAt": "value",
"description": "string",
"id": "id",
"maxCharacters": 1
},
"description": "string",
"id": "id"
}
}
}
}