PUT
/
v1
/
members
/
{id}

Replacing an existing member, identified by their memberId.

As you’re providing the entire desired member state, members with a status of inactive will be re-activated on your Onsi programme.

Relevant Error Codes

If there are any issues with the member replace, 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

Path Parameters

id
string
required

The unique identifier for a Member, prefixed with mem_

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

200 - 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)