POST
https://api.dev.bifrostgaming.com/v1/graphqlguildAddMember
v1Add a player as a guild member (tracked player). If the player already exists for the same platform, their name is updated. If previously removed, the membership is re-activated.
Operation Type
Mutation
Rate Limit: 150 requests per 2 minutes per guild
Supports bulk member additions within the rate limit window.
Important usage notes
- Players who are already guild mods, admins, or owners will be rejected - their stats are automatically tracked through their guild membership.
- The membershipType field is optional and defaults to "community" if not provided. Valid values: "community", "competitive", "tracked_regular".
- Membership type can be updated later via the guild management interface without removing and re-adding the player.
Input Fields
| Field | Type | Required | Description |
|---|---|---|---|
playerId | String! | Required | Unique player identifier (e.g., Steam ID) |
playerName | String! | Required | Player display name |
platform | String! | Required | Player platform: PC, Playstation, or Xbox |
membershipType | String | Optional | Membership category: "community" (default), "competitive", or "tracked_regular". Community members are general guild players, competitive members participate in leagues/scrims, and tracked regulars are non-members whose stats are tracked. |
Code Examples
curl -X POST https://api.dev.bifrostgaming.com/v1/graphql \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"query": "mutation AddMember($input: GuildAddMemberInput!) { guildAddMember(input: $input) { success message error timestamp } }",
"variables": {
"input": {
"playerId": "76561198012345678",
"playerName": "PlayerOne",
"platform": "PC",
"membershipType": "competitive"
}
}
}'Postman Collection
Download a ready-to-use Postman collection for this endpoint. Import it into Postman to start testing immediately.
How to import into Postman
- Open Postman and click Import (top-left)
- Drag and drop the downloaded
.jsonfile, or click Upload Files and select it - Click Import to confirm
- The collection appears in your sidebar — expand it and select the request
- In the Body tab, update the placeholder values (
your-partner-id, etc.) with your actual credentials - Click Send
The collection uses Postman's GraphQL body type, which provides syntax highlighting and variable editing. Make sure your Postman version is 7.2+ for GraphQL support.
Success Response200
{
"data": {
"guildAddMember": {
"success": true,
"message": "Member added to guild"
}
}
}
