Reseller Guide

Managing Tenants

The businesses you have brought onto the platform. You see only your own.

Last updated 2026-10-13

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

Overview

Every tenant you create is automatically attached to your reseller account. The list is filtered to yours — tenants belonging to the platform directly or to another partner are not visible.

Reseller — Reseller tenants list
Reseller tenants list
Reseller tenants list — Your businesses with user counts, combined balances and monthly costs.
  1. 1

    Open Tenants

    Choose Tenants in the reseller portal.

  2. 2

    Create the business

    Enter the business name and owner details. Only the name is required, but contact details make support easier later.

    Reseller — Create tenant form
    Create tenant form
    Create tenant form — Business name, owner, contact details and city.
  3. 3

    Create the owner user

    Go to Users and create an owner for the new business. Until a user exists, nobody can sign in.

  4. 4

    Subscribe and fund

    Give the user the features they need and top up enough balance to cover the first month.

Tenant fields

POST /api/v1/reseller/tenants
ParameterTypeRequiredDescription
business_namestringRequiredThe business's trading name.
owner_namestringOptionalName of the owner.
emailstringOptionalBusiness contact email.
phonestringOptionalBusiness contact phone.
citystringOptionalCity.
countrystringOptionalCountry.
notesstringOptionalYour own notes. Not visible to the business.
NoteThere is no reseller_id field here — tenants you create are attached to you automatically. Reassigning a business to a different partner is a platform administrator action.

What the list shows

ParameterTypeRequiredDescription
tenant_idintegerOptionalIdentifier.
business_namestringOptionalTrading name.
user_countintegerOptionalUsers in this business.
total_balancedecimalOptionalCombined balance of its users, in IQD.
total_monthly_costdecimalOptionalCombined monthly cost of its users.
is_activebooleanOptionalWhether the business is enabled.
TipSort by balance against monthly cost to see which customers need topping up next. Any business holding less than one month of cover is the one to call.

Disabling a tenant

ParameterTypeRequiredDescription
PUT /reseller/tenants/{id}/toggleendpointOptionalEnable or disable one of your businesses.
ImportantDisabling blocks sign-in for every user in that business at once. It does not stop billing — deductions keep running against their balances while they are locked out.

Related