Add Reseller Service Group API
Assign service groups to resellers to define which services they can offer
Add Reseller Service Group API
Assign service groups to resellers to define which subscription plans and services they can offer to their customers. Control reseller product access.
Link Services
Connect resellers to service groups.
Product Control
Define what resellers can sell.
Market Segmentation
Different offerings per reseller.
Endpoint Overview
/graphqlAssign a service group to a reseller, enabling them to offer the services within that group to their customers.
Request Parameters
resellerIdInt!RequiredThe unique identifier of the reseller to assign the service group to.
serviceGroupIdInt!RequiredThe unique identifier of the service group to assign.
GraphQL Mutation
mutation addResellerServiceGroup($resellerId: Int!, $serviceGroupId: Int!) {
addResellerServiceGroup(resellerId: $resellerId, serviceGroupId: $serviceGroupId) {
id
email
firstName
lastName
credit
level
serviceGroups {
id
name
}
}
}Variables:
{
"resellerId": 12345,
"serviceGroupId": 100
}HTTP Request:
curl -X POST https://api.orbnet.com/graphql \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
-d '{
"query": "mutation addResellerServiceGroup($resellerId: Int!, $serviceGroupId: Int!) { addResellerServiceGroup(resellerId: $resellerId, serviceGroupId: $serviceGroupId) { id email serviceGroups { id name } } }",
"variables": {
"resellerId": 12345,
"serviceGroupId": 100
}
}'Response
{
"data": {
"addResellerServiceGroup": {
"id": "12345",
"email": "partner@company.com",
"firstName": "John",
"lastName": "Partner",
"credit": "1500",
"level": "GOLD",
"serviceGroups": [
{
"id": "100",
"name": "Premium VPN Plans"
},
{
"id": "101",
"name": "Basic VPN Plans"
}
]
}
}
}{
"errors": [
{
"message": "Service group with ID 100 not found",
"path": ["addResellerServiceGroup"],
"extensions": {
"code": "NOT_FOUND"
}
}
],
"data": null
}{
"errors": [
{
"message": "Reseller already has this service group assigned",
"path": ["addResellerServiceGroup"],
"extensions": {
"code": "ALREADY_ASSIGNED"
}
}
],
"data": null
}Service Group Benefits
Product Catalog
Define available plans for the reseller.
Pricing Control
Each group can have different pricing.
Feature Sets
Control which features resellers offer.
Market Targeting
Customize offerings for different markets.
Assignment Workflow
Create Service Groups
Create Reseller
Assign Groups
Reseller Active
Best Practices
Start Limited
Begin with basic groups, expand as needed.
Match to Level
Assign groups appropriate to reseller tier.
Review Periodically
Audit assignments for relevance.
Document Assignment
Track why groups were assigned.
Related Endpoints
Multiple Groups
Resellers can have multiple service groups assigned, allowing them to offer a variety of plans to different customer segments.
Create Custom Service Groups
Need specific service offerings? Create custom service groups tailored to your reseller network.