Reseller Guide

Managing Users

Users belong to your tenants and each carries their own balance and subscriptions.

Last updated 2026-10-13

DigitalKey ERP — Docs · digital-key.co/docs/reseller/users

Overview

You can create and manage users for any business attached to your reseller account. Users under other partners, or under the platform directly, are not visible to you.

Reseller — Reseller users list
Reseller users list
Reseller users list — Users across your tenants with role, lifecycle status, balance and monthly cost.

Creating a user

POST /api/v1/reseller/users
ParameterTypeRequiredDescription
tenant_idintegerRequiredWhich of your businesses the user belongs to.
usernamestringRequiredSign-in name. Must be unique across the platform.
passwordstringRequiredInitial password.
full_namestringOptionalDisplay name.
emailstringOptionalEmail address.
phonestringOptionalPhone number.
rolestring= staffRequiredowner or staff.
opening_balancedecimalOptionalBalance to start with. Comes out of your reseller balance.
Warningopening_balance is funded from your balance. Creating a user with an opening balance you cannot cover will fail — check your float first.

Assigning features

PUT /api/v1/reseller/users/{id}/features
ParameterTypeRequiredDescription
feature_idsarrayRequiredThe complete set of feature IDs the user should have. Replaces their current set.
ImportantThis replaces the whole set rather than adding to it. Sending one feature ID removes everything else the user had. Always send the full intended list.
NoteAdding a feature raises the user's monthly cost from their next billing day. It takes nothing from your balance at the moment of subscribing — only top-ups move your float.

Topping up a user

PUT /api/v1/reseller/users/{id}/topup
ParameterTypeRequiredDescription
amountdecimalRequiredAmount to credit, in IQD. Taken from your reseller balance.
notesstringOptionalReference or reason.
TipA top-up to a suspended user first collects the month that failed, then reactivates them. To bring a locked-out customer back, credit at least what they owe — a smaller top-up is kept on their balance and they stay suspended. The credit to the user and the debit from your balance are one transaction, and a repeated click charges no one twice.

Passwords and access

ParameterTypeRequiredDescription
PUT /reseller/users/{id}/passwordendpointOptionalSet a new password for one of your users.
PUT /reseller/users/{id}/toggleendpointOptionalEnable or disable the account.
Warningtoggle suspends an active user — which blocks sign-in and ends any open session — and reactivates a suspended one. See Lifecycle States.

Supporting a customer

When a customer reports being locked out, check in this order:

  1. Is the tenant active? Disabling a business locks out everyone in it.
  2. Is the user account active?
  3. What is their lifecycle_status? suspend and deactivated both refuse sign-in.
  4. Does their balance cover their monthly cost? If not, top up to restore them.

Related