Skip to main content

Create Admin (v1)

Create a new admin account.

Method & Path​

POST /v1/admin/admins

Description​

Creates a new admin account with specified role and permissions.

Authentication​

Required: Admin authentication with admins.manage permission.

Request Body​

{
  "email": "newadmin@example.com",
  "password": "securePassword123",
  "role": "admin",
  "name": "New Admin"
}

Response 201 Created​

{
  "admin": {
    "id": "507f1f77bcf86cd799439011",
    "email": "newadmin@example.com",
    "role": "admin",
    "status": "active"
  }
}

Common Errors​

  • 401 Unauthorized: Missing or invalid admin authentication token
  • 403 Forbidden: Insufficient permissions
  • 400 Bad Request: Invalid request body
  • 409 Conflict: Admin with same email already exists
  • 422 Unprocessable Entity: Validation errors
  • 500 Internal Server Error: Server error