Managing Clients

Last updated: December 16, 2025

Clients are the top-level organizational unit in QR Igniter. Each client can have multiple brands, campaigns, and QR codes.

Client Overview

In a multi-tenant setup, clients typically represent:

  • Companies or organizations you manage QR codes for
  • Different business units within your organization
  • External customers using your QR code platform

Creating a Client

  1. Navigate to Clients in the admin sidebar
  2. Click the New Client button
  3. Fill in the required information
  4. Click Create

Client Fields

Field Required Description
Name Yes The client's company or organization name
Email Yes Primary contact email address
Phone No Contact phone number
Address No Business address
Status Yes Active or Inactive
Notes No Internal notes about the client

Editing a Client

  1. Navigate to the Clients list
  2. Click on the client name or the edit icon
  3. Update the desired fields
  4. Click Save

Deactivating a Client

Instead of deleting clients, you can deactivate them to preserve historical data:

  1. Edit the client
  2. Change Status to Inactive
  3. Click Save
Deactivation Effects

When a client is deactivated, all associated brands, campaigns, and QR codes will stop functioning. Scans will return a "not found" response.

Client Statistics

The client detail page shows:

  • Total number of brands
  • Total number of campaigns
  • Total number of QR codes
  • Total scans across all QR codes

API Access

Clients can also be managed via the REST API:

# List all clients
GET /api/v1/clients

# Create a client
POST /api/v1/clients
{
    "name": "Acme Corp",
    "email": "contact@acme.com",
    "status": "active"
}

# Update a client
PUT /api/v1/clients/{id}

# Delete a client
DELETE /api/v1/clients/{id}

Next Steps