Reseller Create User API
Allow resellers to create new user accounts within their assigned groups
Reseller Create User API
Create new user accounts within your reseller group. Provision VPN access for customers with customizable settings and subscription options.
Create Users
Provision new VPN accounts.
Customizable
Set devices, logins, and more.
Group Scoped
Users belong to your group.
Endpoint Overview
/graphqlCreate a new user within the reseller's assigned group. Set email, password, group assignment, and profile details.
Request Parameters
user.emailString!RequiredEmail address for the new user account (used for login).
user.passwordString!RequiredInitial password for the user account.
user.groupIdInt!RequiredThe subscription group ID from your assigned service groups.
user.firstNameStringUser's first name.
user.lastNameStringUser's last name.
user.userNameStringCustom username for the account.
user.phoneStringContact phone number.
user.countryStringUser's country code.
user.langStringPreferred language code.
user.devicesIntMaximum number of devices allowed.
user.loginIntMaximum concurrent login count.
GraphQL Mutation
mutation resellerCreateUser($user: ResellerUserCreate!) {
resellerCreateUser(user: $user) {
id
email
username
resellerId
role
enabled
radAccess
createdAt
}
}Variables:
{
"user": {
"email": "customer@example.com",
"password": "SecurePass123!",
"groupId": 100,
"firstName": "John",
"lastName": "Customer",
"userName": "johncustomer",
"country": "US",
"phone": "+1234567890",
"devices": 5,
"login": 3
}
}HTTP Request:
curl -X POST https://api.orbnet.com/graphql \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_RESELLER_TOKEN" \
-d '{
"query": "mutation resellerCreateUser($user: ResellerUserCreate!) { resellerCreateUser(user: $user) { id email username enabled createdAt } }",
"variables": {
"user": {
"email": "customer@example.com",
"password": "SecurePass123!",
"groupId": 100
}
}
}'Response
{
"data": {
"resellerCreateUser": {
"id": "user_12345",
"email": "customer@example.com",
"username": "johncustomer",
"resellerId": "reseller_789",
"role": "user",
"enabled": true,
"radAccess": "generated_access_key",
"createdAt": "2024-01-15T10:30:00Z"
}
}
}{
"errors": [
{
"message": "User with this email already exists",
"path": ["resellerCreateUser"],
"extensions": {
"code": "EMAIL_EXISTS"
}
}
],
"data": null
}{
"errors": [
{
"message": "Insufficient credits to create user",
"path": ["resellerCreateUser"],
"extensions": {
"code": "INSUFFICIENT_CREDITS"
}
}
],
"data": null
}User Settings
Device Limit
Control how many devices can connect.
Concurrent Logins
Set simultaneous session limit.
Group Assignment
Assign to your service groups.
Access Control
Enable/disable VPN access.
Best Practices
Strong Passwords
Require secure passwords for users.
Complete Profiles
Include contact info for support.
Appropriate Group
Match group to customer needs.
Track Credits
Monitor credit usage per user.
Related Endpoints
Credit Deduction
Creating a user deducts credits from your reseller balance based on the assigned group pricing.
Manage Your Users
View and manage all users you've created.