POST
/
customers
cURL
curl --request POST \
  --url https://app.masivo.ai/api/storefront/v1/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "<string>",
  "status": "ACTIVE",
  "name": "John Smith",
  "email": "jsmith@example.com",
  "gender": "MALE",
  "dob": "2023-11-07T05:31:56Z",
  "registration_date": "2023-11-07T05:31:56Z",
  "tier_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "tags": {},
  "metrics": {},
  "metadata": {}
}'
{
  "data": {
    "customer": {
      "id": "<string>",
      "status": "ACTIVE",
      "name": "John Smith",
      "email": "jsmith@example.com",
      "gender": "MALE",
      "dob": "2023-11-07T05:31:56Z",
      "registration_date": "2023-11-07T05:31:56Z",
      "tier_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "tags": {},
      "metrics": {},
      "metadata": {}
    },
    "wallet": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "owner_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "lines": [
        {
          "amount": 123,
          "reward_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "campaign_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "brand_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "issued_at": "2023-11-07T05:31:56Z",
          "expiration_date": "2023-11-07T05:31:56Z",
          "reservation_expires_at": "2023-11-07T05:31:56Z"
        }
      ],
      "totals": [
        {
          "total": 127.6,
          "reward_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "expiration_date": "2023-11-07T05:31:56Z",
          "reward": {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "brand_id": "<string>",
            "name": "<string>",
            "description": "<string>",
            "type": "POINTS",
            "conditions": [
              [
                {
                  "type": "Order Value",
                  "operator": "grater than",
                  "primitive": "string",
                  "value": 9.95
                }
              ]
            ],
            "attributes": {
              "conversion_factor": 0.1
            }
          }
        }
      ]
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
id
string
required

Your customer unique identifier

​
name
string
required

The full name of the customer

Example:

"John Smith"

​
email
string<email>
required

The email of the customer

​
registration_date
string<date-time>
required

The date when the customer was registered

​
status
enum<string>

The status of the customer

Available options:
ACTIVE,
INACTIVE
​
gender
enum<string> | null

The gender of the customer

Available options:
MALE,
FEMALE
​
dob
string<date-time> | null

The date of birth of the customer

​
tier_id
string<uuid>

The id of the tier the customer currently belongs to

​
tags
object

Include your conditions customer tags here

​
metrics
object

The metrics of the customer

​
metadata
object

The metadata of the customer

Response

Customer created

​
data
object