Skip to main content
POST
/
api
/
v2
/
admin
/
team-members
/
{tenantId}
Add team member
curl --request POST \
  --url https://faisalshop.mvp-apps.ae/api/v2/admin/team-members/{tenantId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "jsmith@example.com"
}
'
{
  "message": "<string>"
}

​
Overview

Add a new or existing user to a tenant. If the user doesn’t exist, a new account will be created automatically.

​
Authorization

  • User must be authenticated with a valid Bearer token
  • User must have ADMIN role in the specified tenant

​
Behavior

  • If the email doesn’t exist in the system, creates a new user account
  • If the user exists, adds them to the tenant with the specified role
  • Sets is_active to true and updates last_active_at
  • Fires a UserRegistered event for webhook integrations

​
Validation Rules

  • email: Required, must be a valid email format
  • role: Required, must be either “ADMIN” or “MEMBER”

​
Example Usage

curl -X POST \
  https://faisalshop.mvp-apps.ae/api/v2/admin/team-members/1 \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "newuser@example.com",
    "role": "MEMBER"
  }'

await axios.post(
  `/api/v2/admin/team-members/${tenantId}`,
  {
    email: 'newuser@example.com',
    role: 'MEMBER'
  },
  {
    headers: { Authorization: `Bearer ${token}` }
  }
);

​
Error Responses

​
Already a Member (400)

{
  "error": "user@example.com is already a member of this Organization"
}

​
Validation Error (422)

{
  "message": "The email field must be a valid email address.",
  "errors": {
    "email": ["The email field must be a valid email address."]
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
tenantId
integer
required

Tenant ID

Body

application/json
​
email
string<email>
required
​
role
enum<string>
required
Available options:
ADMIN,
MEMBER

Response

200 - application/json

Member added

​
message
string