Create Team Member | Gradii API Documentation

curl -X POST https://gradii.ai/api/v2/teams \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "firstName": "Jane",
  "lastName": "Smith",
  "email": "jane@example.com",
  "password": "SecurePass123!",
  "department": "Human Resources",
  "title": "HR Coordinator",
  "role": "hr",
  "sso": false
}'

{
  "success": true,
  "data": {
    "member": {
      "id": "team-member-uuid",
      "userId": "user-uuid",
      "personal": {
        "firstName": "Jane",
        "lastName": "Smith",
        "email": "jane@example.com"
      },
      "role": {
        "title": "hr",
        "department": "Human Resources",
        "jobTitle": "HR Coordinator"
      },
      "status": {
        "isActive": true,
        "joinedAt": "2024-01-28T10:00:00.000Z"
      },
      "credentials": {
        "email": "jane@example.com",
        "temporaryPassword": "SecurePass123!"
      },
      "company": {
        "name": "Acme Corp"
      }
    }
  },
  "message": "Team member created successfully and welcome email sent",
  "timestamp": "2024-01-28T10:00:00Z",
  "version": "2.0"
}

Create a new HR team member directly with automatic welcome email. User is pre-verified.

Authentication

AuthorizationBearer

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

Request

Creates both user and team member records Sends welcome email with credentials automatically User is pre-verified (emailVerified set to current time) Password is included in welcome email User should change password on first login

firstNamestringRequired

First name (1-100 chars)

lastNamestringRequired

Last name (1-100 chars)

emailstringRequiredformat: "email"

Valid email address

passwordstringRequired

Password (8-100 chars)

departmentstringRequired

Department (1-255 chars)

titlestringRequired

Job title (1-255 chars)

rolestringRequired

Must be 'hr'

ssobooleanOptional

SSO enabled (default: false)

Response

Team member created successfully and welcome email sent

successbooleanOptional

dataobjectOptional

messagestringOptional

timestampstringOptional

versionstringOptional

Errors

409

Conflict Error