Promote to Admin

The Promote to Admin endpoint invites an existing user to become a manager (admin) in Connecteam. A successful API response means the invitation was sent — it does not mean the user is an admin yet.

Endpoint

POST /users/v1/admins

Request Body

Request Example

{
  "userId": 7031021,
  "email": "[email protected]",
  "title": "Team Manager"
}

Success Response (200)

{
  "requestId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "data": {
    "success": true,
    "userId": 7031021
  }
}

🚧

Important

A 200 response means the promote-to-admin request succeeded and an invitation email was sent. The user does not become an admin — and does not receive admin permissions — until they accept the invitation. Until then, their user type remains unchanged.

What Happens When You Call This Endpoint

1. The user's email address is replaced with the email submitted in the request
2. An invitation email is sent to that address
3. The API returns 200 to confirm the invitation was created and sent

What Happens After the User Accepts

Only after the invited user accepts the invitation:

1. Their user type changes from user to admin
2. They become an actual admin in the system with the relevant admin permissions

Error Responses

Example — title omitted:

{
  "details": {
    "error_message": "Request body is invalid",
    "error_code": 1002
  },
  "error": {
    "body.title": {
      "message": "field required",
      "type": "value_error.missing"
    }
  }
}

📘

Note

To demote an admin back to a regular user, use the Update Users endpoint with the appropriate userType.

Promote to Admin API reference