Batch create points events

post

https://developer-api.rivo.io/merchant_api/v1/points_events/batch

Create multiple points events in a single request.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

📘
Please note this endpoint is in BETA for 7 days until March 9th 2026

Example:

curl -X POST https://developer-api.rivo.io/merchant_api/v1/points_events/batch \
    -H "Authorization: abcxyz" \
    -H "Content-Type: application/json" \
    -d '{
      "points_events": [
        {
          "customer_identifier": "7977878356070",
          "source": "manual",
          "points_amount": 100,
          "internal_note": "Batch test"
        },
        {
          "customer_identifier": "7953156014182",
          "source": "manual",
          "points_amount": 200,
          "internal_note": "VIP bonus"
        }
      ]
    }'

Form Data

points_events[customer_identifier]

array of strings

required

Shopify Customer ID or Email

points_events[customer_identifier]*

points_events[source]

array of strings

required

Source associated with the points event. Choose manual by default.

points_events[source]*

points_events[points_amount]

array of int32s

Number of points. Use positive numbers to add points and negative numbers to subtract points.

points_events[points_amount]

points_events[credits_amount]

array of floats

Number of credits. Use positive numbers to add credits and negative numbers to subtract credits.

points_events[credits_amount]

points_events[internal_note]

array of strings

Internal facing note on why the points were granted.

points_events[internal_note]

points_events[external_note]

array of strings

External facing note on why the points were granted.

points_events[external_note]

points_events[applied_at]

array of date-times

Time the event took place. Defaults to the current time if left blank.

points_events[applied_at]

points_events[custom_action_name]

array of strings

Required when creating a points event for a custom action or visit URL.

points_events[custom_action_name]

Headers

Authorization

string

required

Merchant Auth Token

Response

201

Create multiple points events in a single request.

Language

Loading…

Response

Click Try It! to start a request and see the response here!