Create employee and provision FluideAuth staff seat (single request)

curl -sS -X POST "$FLUIDE_BASE_URL/api/v1/hr/employees/onboard-with-staff" \ -H "Authorization: Bearer $FLUIDE_ACCESS_TOKEN" \ -H "X-Fluide-Api-Key: $FLUIDE_API_KEY" \ -H "X-Fluide-Client-Id: fluide-developer" \ -H "Content-Type: application/json" \ -d '{}'

Authorizations

Authorization

string

header

required

Access token JWT. Use as Authorization: Bearer . In the API playground, paste the JWT only.

X-Fluide-Api-Key

string

header

default:fl_dev_your_key

required

Developer API key (fl_dev_...). Required on every API call with a machine access token.

X-Fluide-Client-Id

string

header

default:fluide-developer

required

First-party client audience. Must match the fluide_client_id claim on the JWT. Use fluide-developer for Connect.

Body

application/json

employeeCode

string

required

Maximum string length: 50

firstName

string

required

Maximum string length: 100

lastName

string

required

Maximum string length: 100

string<email>

required

sendStaffSetupEmail

boolean

required

Send staff-first-access email when outbound mail is configured

userId

string<uuid>

phone

string

Maximum string length: 32

departmentId

string<uuid>

costCenterId

string<uuid>

profitCenterId

string<uuid>

branchId

string<uuid>

designation

string

employmentType

enum<string>

Available options:

FULL_TIME,

PART_TIME,

CONTRACT,

INTERN

status

enum<string>

Available options:

PENDING,

ACTIVE,

INACTIVE,

TERMINATED,

ON_LEAVE

salary

number

currency

string

Maximum string length: 3

complianceFlags

object

profileExtensions

object

hireDate

string

correlationId

string

Maximum string length: 128

Response

Created successfully

success

boolean

required

Whether the request succeeded

Example:

true

message

string

required

Human-readable outcome message (localized when i18n is configured)

Example:

"Operation completed successfully"

data

object

Endpoint-specific payload