Members

Member accessing and altering endpoints.

Returns all members for a given merchant. Merchant is pulled from the public API key for security reasons.

Pagination is supported by passing limit and lastCustomerId values as
query parameters. You will get a lastCustomerId value in the response
of the previous request, which can be used for the next.

get

/v2.0/admin/members

Query parameters

limitstringrequired

lastCustomerIdstringrequired

Header parameters

X-Inveterate-Api-Keystringrequired

Your private Inveterate API key.

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v2.0/admin/members?limit=text&lastCustomerId=text' \
  --header 'X-Inveterate-Api-Key: text'

200

400

500

200

{
  "message": "text",
  "data": {}
}

Returned upon successful direct action to our database. Action is immediate.

This endpoint is used to create a free tier member. You can also provide a credit value to add credits to the new members account.<br> The overrideSpendThreshold parameter allows you to add customers to a spend based tier, and the keepInSpendBasedTier parameter<br> ensures that the member won't be downgraded if they don't hit the spend minimum.<br><br> NOTE: This endpoint will downgrade a customer specified to a lower tier if that is the tier provided to the endpoint!

post

/v2.0/admin/members

Header parameters

X-Inveterate-Api-Keystringrequired

Your private Inveterate API key.

Body

customerIdstringrequired

The customerId to add to the specified free tier.

referralsstringrequired

The signify whether or not the customer was referred. NOTE: NOT to be used to indicate the referring customer.

segmentIdstringrequired

The segmentId of the tier you want to add this customer to.

overrideSpendThresholdbooleanrequired

Whether or not to override the spend required to add a cutomer to a spend based tier.

keepInSpendBasedTierbooleanrequired

Whether or not you want to keep this customer in the spend based tier despite not meeting the spend threshold.

creditsnumber · min: 1required

Especially for member creation requests, if you would like to add some credits to the specified customer.

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v2.0/admin/members' \
  --header 'X-Inveterate-Api-Key: text' \
  --header 'Content-Type: application/json' \
  --data '{"customerId":"text","referrals":"text","segmentId":"text","overrideSpendThreshold":true,"keepInSpendBasedTier":true,"credits":1}'

201

400

500

201

{
  "message": "text",
  "data": {}
}

Returned upon successful request made to our backend. Requests that return this code may take a small amount of time after successful API return to fully update.

Returns a single member for a given merchant. Merchant is pulled from the public API key for security reasons.

get

/v2.0/admin/members/{id}

Path parameters

idstringrequired

The customer ID number which you would like to retrieve.

Header parameters

X-Inveterate-Api-Keystringrequired

Your private Inveterate API key.

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v2.0/admin/members/{id}' \
  --header 'X-Inveterate-Api-Key: text'

200

400

500

200

{
  "message": "text",
  "data": {}
}

Returned upon successful direct action to our database. Action is immediate.

This endpoint is used to update a member. It takes a member ID and uses your public API key to match the customer to your account. As of now, all fields in the update schema are required, so it is not possible to update a single field at a time.

patch

/v2.0/admin/members/{id}

Path parameters

idstringrequired

The customer ID number which you would like to update.

Header parameters

X-Inveterate-Api-Keystringrequired

Your private Inveterate API key.

Body

firstNamestringrequired

The customer's first name.

lastNamestringrequired

The customer's last name.

notesstringrequired

Internal notes for this customer. Only viewable by the merchant.

phoneNumberstringrequired

The customer's phone number.

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PATCH \
  --url '/v2.0/admin/members/{id}' \
  --header 'X-Inveterate-Api-Key: text' \
  --header 'Content-Type: application/json' \
  --data '{"firstName":"text","lastName":"text","notes":"text","phoneNumber":"text"}'

201

400

500

201

{
  "message": "text",
  "data": {}
}

Returned upon successful request made to our backend. Requests that return this code may take a small amount of time after successful API return to fully update.