Create Reseller API
Create new reseller accounts with customizable credit, level, and permissions
Create Reseller API
Create new reseller accounts with customized permissions and credit limits. Resellers can manage users and distribute services within your platform.
Quick Onboarding
Create reseller accounts instantly.
Tiered System
Assign levels with different perks.
Credit System
Set initial credit balance.
Endpoint Overview
/graphqlCreate a new reseller account with specified email, password, credit balance, level, and contact information.
Request Parameters
resellerResellerCreate!RequiredThe reseller creation input object containing all account details.
reseller.emailString!RequiredThe reseller's email address (used for login and notifications).
reseller.passwordString!RequiredThe initial password for the reseller account.
reseller.creditStringInitial credit balance for the reseller account.
reseller.levelResellerLevelNameThe tier/level to assign (determines permissions and limits).
reseller.phoneStringContact phone number for the reseller.
reseller.firstNameStringReseller's first name.
reseller.lastNameStringReseller's last name.
GraphQL Mutation
mutation createReseller($reseller: ResellerCreate!) {
createReseller(reseller: $reseller) {
id
email
firstName
lastName
credit
level
phone
createdAt
}
}Variables:
{
"reseller": {
"email": "partner@company.com",
"password": "SecurePass123!",
"credit": "1000",
"level": "GOLD",
"phone": "+1234567890",
"firstName": "John",
"lastName": "Partner"
}
}HTTP Request:
curl -X POST https://api.orbnet.com/graphql \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
-d '{
"query": "mutation createReseller($reseller: ResellerCreate!) { createReseller(reseller: $reseller) { id email firstName lastName credit level } }",
"variables": {
"reseller": {
"email": "partner@company.com",
"password": "SecurePass123!",
"credit": "1000",
"level": "GOLD"
}
}
}'Response
{
"data": {
"createReseller": {
"id": "12345",
"email": "partner@company.com",
"firstName": "John",
"lastName": "Partner",
"credit": "1000",
"level": "GOLD",
"phone": "+1234567890",
"createdAt": "2024-01-15T10:30:00Z"
}
}
}{
"errors": [
{
"message": "A reseller with this email already exists",
"path": ["createReseller"],
"extensions": {
"code": "EMAIL_EXISTS"
}
}
],
"data": null
}Reseller Levels
Bronze
Entry-level with basic permissions and lower credit limits.
Silver
Mid-tier with expanded access and moderate limits.
Gold
Premium tier with high limits and priority support.
Platinum
Top tier with maximum permissions and unlimited access.
Best Practices
Strong Passwords
Enforce strong password requirements for security.
Appropriate Level
Start resellers at appropriate tier for their needs.
Verify Identity
Validate reseller identity before granting access.
Document Terms
Ensure reseller agreement is in place.
Related Endpoints
Initial Setup
After creating a reseller, assign service groups using the Add Reseller Service Group API to define which services they can offer.
Manage Reseller Permissions
Assign service groups to control which services your new reseller can distribute.