Skip to content

Users

User management is an Admin-only feature. WedoCOD supports multiple user roles, each with a dedicated CRUD interface.

User Roles

RoleDescription
AdminPlatform administrators with full access
Manager LeaderManages groups of managers
ManagerManages agents and team operations
SellerProduct sellers with their own accounts
AgentCall center agents who process leads
Sourcing AgentHandles product sourcing requests
Stock ManagerManages warehouse inventory
Call Center ManagerManages call center operations
DeliveryDelivery personnel
Follow-Up AgentHandles post-sale customer follow-up

Common Endpoints

Every user role follows the same endpoint pattern. Replace {role} with the role slug from the table below:

RoleURL Slug
Adminadmins
Manager Leadermanager-leaders
Managermanagers
Sellersellers
Agentagents
Sourcing Agentsourcing-agents
Stock Managerstock-managers
Call Center Managercall-center-managers
Deliverydeliveries
Follow-Up Agentfollow-up-agents

List Users

GET/users/{role}🔒 Session — can viewAny

Paginated list of users for a specific role.

Create User

POST/users/{role}/store🔒 Session — can create

Create a new user.

Common fields (all roles):

FieldTypeRequiredDescription
full_namestringYesFull name (1–100 chars)
phonestringYesPhone number (1–100 chars)
emailstringYesEmail (unique, valid format)
passwordstringYesPassword (must be confirmed)
statusstringYesUser status (enum value)

Additional fields by role:

RoleExtra Fields
Agentwhatsapp_phone, company, salary (numeric), products_ids_to_confirm (array), agent_working_hours (array with startTime/endTime), agent_status_handlings (array)
Sellercompany (optional), whatsapp_phone (optional)
Managerwhatsapp_phone, company
Manager Leader(no extra fields)
Call Center Managerwhatsapp_phone, company
Stock Managerwhatsapp_phone, company, warehouses_ids_to_manage (array)
Deliverywhatsapp_phone, company
Follow-Up Agentwhatsapp_phone, company
Sourcing Agentwhatsapp_phone, company

Show User

GET/users/{role}/{item}/show🔒 Session — can view

View user details.

Update User

PATCH/users/{role}/{item}/update🔒 Session — can update

Update user details. Password is optional on update.

Activate / Deactivate User

POST/users/{role}/{item}/activate🔒 Session

Activate a user account.

POST/users/{role}/{item}/deactivate🔒 Session

Deactivate a user account.

INFO

Activate/deactivate endpoints are available for Admins, Manager Leaders, and Sellers.

Impersonation

POST/users/{item}/login-as🔒 Session — can loginAs

Log in as another user (impersonation). Admin only.

POST/users/login-back🔒 Session

Return to original admin session after impersonation.

Search Users

Search endpoints return [{id, text}] for autocomplete:

GET/search/users/admins🔒 Session

Search admin users.

GET/search/users/sellers🔒 Session

Search seller users.

GET/search/users/managers🔒 Session

Search manager users.

GET/search/users/agents🔒 Session

Search agent users.

GET/search/users/deliveries🔒 Session

Search delivery users.

GET/search/users/teams🔒 Session

Search teams.

GET/search/users/manager-leaders🔒 Session

Search manager leaders.

GET/search/users/call-center-managers🔒 Session

Search call center managers.

WedoCOD Documentation