POST
/
v1
/
members

This invites a new member to your platform, when they are created they will have the status of invited, if their email already has an associated Onsi account their status will go straight to active.

Relevant Error Codes

If there are any issues with the member add, the API will return a 400 status code with the following error codes:

Authorizations

X-API-KEY
string
header
required

Headers

x-idempotency-key
string

Unique key to ensure idempotency of the request

Body

application/json
email
string
required

A unique email address for the member

firstName
string
required
lastName
string
required
tier
string
required

Tier name for the member

accountDetails
object
enablePayroll
boolean
phone
string

An optional phone number for the member

workerId
string

Unique ID provided by API consumer, must be unique across all members (active, invited and inactive)

Response

201 - application/json

A member on the platform.

accountDetails
object
required
email
string
required
enablePayroll
boolean
required
firstName
string
required
lastName
string
required
memberId
string
required

Onsi's ID of the member

phone
string | null
required
status
enum<string>
required

The status of the member.

Available options:
active,
invited,
inactive
tier
string
required

Tier name for the member

workerId
string | null
required

Unique ID provided by API consumer, must be unique across all members (active, invited and inactive)