Skip to main content
POST
/
api
/
v1
/
loyalty-events
cURL
curl --request POST \
  --url https://api-staging.getmeadow.com/api/v1/loyalty-events \
  --header 'Content-Type: application/json' \
  --header 'X-Client-Key: <api-key>' \
  --header 'X-Consumer-Key: <api-key>' \
  --data '
{
  "customerEmail": "[email protected]",
  "pointsAmount": 55.7,
  "reason": "New customer promotion"
}
'
{
  "data": {
    "organizationId": 1,
    "userId": 4,
    "type": "open-api",
    "pointsAmount": 55.7,
    "reason": "New customer promotion",
    "updatedAt": "2025-10-13T15:53:44.336Z",
    "createdAt": "2025-10-13T15:53:44.336Z",
    "id": 1
  }
}

​
Identify the customer

Include at least one of the following fields in the request body so Meadow can locate the customer that should receive the loyalty points:
  • customerId
  • customerEmail
  • customerPhone
If the customer could not be found then the API will return a 404 response with an error.code of USER_NOT_FOUND.

Authorizations

​
X-Consumer-Key
string
header
required

The key assigned to your company and provided via Meadow

​
X-Client-Key
string
header
required

The key generated and provided by our mutual client

Body

application/json
​
pointsAmount
number
required

The number of loyalty points to award to the customer.

​
reason
string
required

A note describing why the points are being awarded.

​
customerId
number

The customer id, as returned by customer endpoints.

​
customerEmail
string

The email address of the customer to receive the points.

​
customerPhone
string

The phone number of the customer to receive the points.

Response

Loyalty event response

​
id
number

The ID of the loyalty event

​
type
string

The source of the loyalty event, will always be open-api for events created through this API

​
pointsAmount
number

The number of points awarded in this event

​
reason
string

A description explaining why the points were awarded

​
createdAt
string

When the loyalty event was created

​
updatedAt
string

When the loyalty event was last updated