Approver

Create Approver

Create a new approver profile. role must be passed as APPROVER and createdBy as any non-empty string — both are required by DTO validation and will be overridden server-side for OAuth requests. entityId must be a valid company UUID; the downstream employment service rejects the request with 400 if it is missing or empty.

Authentication

AuthorizationBearer

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

Headers

vnd.a1.tenant-idstringOptional

Tenant identifier for multi-tenant environments

Request

This endpoint expects an object.
firstNamestringRequired
lastNamestringRequired
emailAddressstringRequiredformat: "email"
roleenumRequired

Must be APPROVER. Server enforces this for OAuth but DTO validation still requires the field.

Allowed values:
createdBystringRequired

Pass any non-empty string. Overridden to oauth server-side for OAuth requests.

entityIdstringRequired

UUID of the associated company entity. Required — the employment service rejects the request if absent.

middleNamestringOptional
knownAsstringOptional
contactobjectOptional
workplacestringOptional
customerIdstringOptional

Response

Approver created successfully
uuidstringOptionalformat: "uuid"

Errors

409
Conflict Error