Customer Object

A core object in this API.

The Customer object is essentially a mirror of the Customer object from the Shopify, with our loyalty specific attributes attached.

  "type": "customer",
  "id": 123,
  "attributes": {
    "id": 123,
    "email": "[email protected]",
    "first_name": "Stuart",
    "last_name": "Example",
    "accepts_marketing": true,
    "orders_count": 0,
    "verified_email": true,
    "total_spent": 0.0,
    "shopify_tags": [
    "loyalty_points_tally": 1000,
    "loyalty_status": "member",
    "loyalty_status_last_updated_at": null,
    "dob": "07-13",
    "dob_last_updated_at": "2022-07-31T13:47:32.841Z",
    "referral_url": "",
    "vip_tier": {
        "id": 1,
        "name": "Gold",
        "threshold": 1250,
        "perks": [],
        "icon_url": null,
        "desc": null,
        "rewards": []

Customer Identifier

We've made it simple to identify a customer when making API requests.

You can pass either the Shopify Customer ID or Shopify Customer email using the customer_identifier parameter.


Important note on latency from Shopify API

For a new customer to appear in our system, Rivo relies on the Shopify API to send us a webhook, which can take up to 30 seconds. With this latency, please note that there may be a delay of 30-60 seconds before you can access a new customer in our system.