Mutation
mutation CreateBadgeMemberships($input: CreateBadgeMembershipsInput!) {
createBadgeMemberships(input: $input) {
badge {
avatarUrl
color
createdAt
creator {
ambassadorLevel
ambassadorLevelId
avatarUrl
badges {
__typename
}
conversations {
__typename
}
customFieldResponses {
__typename
}
}
customField {
allowAdHoc
answers {
__typename
}
createdAt
description
id
maxCharacters
}
description
}
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
}
}Variables
{
"input": {
"badgeId": "id",
"memberIds": [
"id"
]
}
}Response
{
"data": {
"createBadgeMemberships": {
"badge": {
"avatarUrl": "string",
"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"
},
"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"
}
}
}Mutations
createBadgeMemberships
Assign a badge to members. Pass the badge ID and the member IDs to grant it to.
Required scope: host:write:network_members
MUTATION
createBadgeMemberships(input: CreateBadgeMembershipsInput!): CreateBadgeMembershipsPayloadArguments
input
required
Parameters for CreateBadgeMemberships
badge
clientMutationId
String
A unique identifier for the client performing the mutation.
errors
[String!]!
grantedMembers
[Member!]!
The members newly granted the badge — excludes any who already had it.
outcome
Mutation
mutation CreateBadgeMemberships($input: CreateBadgeMembershipsInput!) {
createBadgeMemberships(input: $input) {
badge {
avatarUrl
color
createdAt
creator {
ambassadorLevel
ambassadorLevelId
avatarUrl
badges {
__typename
}
conversations {
__typename
}
customFieldResponses {
__typename
}
}
customField {
allowAdHoc
answers {
__typename
}
createdAt
description
id
maxCharacters
}
description
}
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
}
}Variables
{
"input": {
"badgeId": "id",
"memberIds": [
"id"
]
}
}Response
{
"data": {
"createBadgeMemberships": {
"badge": {
"avatarUrl": "string",
"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"
},
"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"
}
}
}