Create or Update Member

POST/members

Creates a new member or updates an existing one (upsert behavior)

Authorization

AuthorizationBearer <token>

Use your private API key (sk_xxx) as the bearer token

In: header

Request Body

application/json

externalId*string

Your unique identifier for this user

email?string

Formatemail

name?string

avatarUrl?string

Formaturi

phone?string

dateOfBirth?string

Formatdate

metadata?

Response Body

`application/json`

curl -X POST "https://app.useloyalty.app/api/v1/members" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "user_123",
    "email": "john@example.com",
    "name": "John Doe",
    "metadata": {
      "plan": "premium"
    }
  }'

curl -X POST "https://app.useloyalty.app/api/v1/members" \  -H "Content-Type: application/json" \  -d '{    "externalId": "user_123",    "email": "john@example.com",    "name": "John Doe",    "metadata": {      "plan": "premium"    }  }'

{
  "id": "string",
  "externalId": "string",
  "email": "user@example.com",
  "name": "string",
  "avatarUrl": "http://example.com",
  "points": 0,
  "totalPointsEarned": 0,
  "currentStreak": 0,
  "longestStreak": 0,
  "metadata": {},
  "createdAt": "2019-08-24T14:15:22Z"
}

{
  "error": "string",
  "message": "string"
}

Empty

Create or Update Member

Authorization

Request Body

Response Body

200application/json

400application/json

401

`application/json`

`application/json`