Adding & Managing Agents

3 min readPublished April 12, 2026

How to Add a New Agent

Adding a commission agent captures their contact details, company information, identification documents, and default commission settings.

  1. 1Go to the Agents page from the sidebar navigation.
  2. 2Click the 'Add Agent' button in the top right corner.
  3. 3Enter the agent's Full Name (required).
  4. 4Enter the Mobile Number using the phone input with country code selector (required). The country code defaults to your shop's country. Fixmo checks for duplicate phone numbers in real time.
  5. 5Enter the Nickname (optional) — a short name or alias for quick identification.
  6. 6Enter the Email address (optional). Fixmo checks for duplicate emails as you type.
  7. 7Enter the Address (optional).
  8. 8Fill in Company Details if applicable (all optional): Company Name, Website, Company Email, Company Phone, and Company Address.
  9. 9Upload agent ID documents if needed — NIC, passport, or driving license (max 5 files).
  10. 10Upload company documents if needed — business registration or tax certificates (max 5 files).
  11. 11Set the Default Commission Rate (numeric value).
  12. 12Select the Commission Type: Percentage, Fixed, Per Product, or Per Service.
  13. 13Click 'Save' to create the agent.
Note

The default commission rate and type are applied automatically when this agent is linked to a sale or repair. You can override these values per transaction at creation time.

How to Edit an Agent

Update any agent's information from their detail page. Duplicate detection also works when editing, excluding the agent's own phone and email.

  1. 1Click an agent row on the Agents list page to open their detail page.
  2. 2Click the 'Edit' button in the header.
  3. 3Update any fields — name, nickname, phone, email, address, company details, documents, or commission settings.
  4. 4Click 'Save Changes' to apply your updates.

Deactivating an Agent

When an agent is no longer working with your shop, deactivate them instead of deleting to preserve historical records.

  • Deactivation sets the agent's active status to false (soft delete).
  • Deactivated agents cannot be selected when creating new sales or repairs.
  • All existing commission records and payout history are preserved.
  • Only Admins can deactivate agents. Managers cannot perform this action.
  1. 1Open the agent's detail page by clicking their row in the Agents list.
  2. 2Click the deactivate option (Admin only).
  3. 3Confirm the deactivation in the dialog.
Warning

Deactivation does not affect existing commission records or pending payouts. You should settle any outstanding balance before deactivating an agent.

Frequently Asked Questions

What fields are required when adding an agent?+
Only two fields are required: Full Name and Mobile Number. The mobile number goes through phone validation with country code selection and duplicate checking. All other fields including nickname, email, address, company details, documents, and commission settings are optional.
Can I upload documents for an agent?+
Yes. You can upload up to 5 agent ID documents (NIC, passport, driving license) and up to 5 company documents (business registration, tax certificates). These are stored securely and accessible from the agent's detail page.
Can I deactivate an agent instead of deleting them?+
Yes. Deactivation is a soft delete — the agent's active status is set to false. Deactivated agents cannot be selected for new sales or repairs, but their full commission and payout history is preserved. Only Admins can deactivate agents.
What happens if I enter a duplicate phone or email?+
Fixmo checks phone numbers and email addresses in real time as you type. If a match is found with an existing agent, a warning appears below the field. The save button is disabled until the duplicate is resolved.

Related Articles

Commission Agents3 min read

Commission Agents Overview

Learn what commission agents are in Fixmo, how to manage external salespeople and referrers, track earned commissions, and record payouts from the Agents dashboard.

Read article
Commission Agents3 min read

Commission Types Explained

Understand the four commission types in Fixmo — Percentage, Fixed, Per Product, and Per Service — with formulas, examples, and how default rates and overrides work.

Read article
Commission Agents3 min read

Linking Agents to Sales & Repairs

Learn how to assign a commission agent when creating a sale or repair in Fixmo, override default rates, and understand how commission records are generated.

Read article
Commission Agents3 min read

Recording Agent Payouts

Record commission payouts to agents in Fixmo — enter amounts, select payment methods, add references and notes, and track payout history from the agent detail page.

Read article