Skip to main content
POST
Error

Authorizations

Authorization
string
header
required

Prefix the value with "ApiKey" to indicate the custom authorization type

Path Parameters

personId
string<uuid>
required

Response

OK

A person (employee) record in Firstbase

id
string<uuid>
required

Unique identifier for this person

Example:

"e2bd9633-46b4-4286-85bd-3403a3f17e0f"

role
enum<string>
required

Role of this person within the organization (BASIC = standard employee, ADMIN = org admin)

Available options:
BASIC,
ADMIN
Example:

"BASIC"

firstName
string
required

First name of the person

Example:

"Jenny"

lastName
string
required

Last name of the person

Example:

"Smith"

email
string
required

Primary email address, used for platform login and notifications

Example:

"jenny@example.com"

status
enum<string>
required

Current lifecycle status of the person in Firstbase (e.g. INVITED, ACTIVE, OFFBOARDING)

Available options:
INVITED,
ACTIVE,
INACTIVE,
DELETED,
OFFBOARDING,
CANNOT_REACTIVATE
secondaryEmail
string

Secondary email address; null when not provided

Example:

"jenny@secondary.example.com"

phoneNumber
string

Phone number from the person's home address; null when not provided

Example:

"555-867-5309"

startDate
string<date>

Employment start date, used to trigger onboarding timelines

Example:

"2023-11-22"

homeAddress
object

Home address of the person, used for equipment deliveries

package
object

Equipment package currently assigned to this person; null when no package is assigned

cpfNumber
string

Brazilian CPF tax number; null for non-Brazilian employees

Example:

87523654789