---
title: "Record Loyalty Customer Action"
method: POST
path: "/loyalty/v3/stores/store_id/custom_actions"
---

# Record Loyalty Customer Action

`POST /loyalty/v3/stores/store_id/custom_actions`

## Path parameters

- `account_id` string, required

## Query parameters

- `access_token` string

## Request body

- object
  - `custom_action` object
  - `type` string, required — The type of action. Almost always set this to `CustomAction`
  - `customer_email` string, required — The email address used to identify the customer who performed the action.
  - `customer_id` string — The unique identifier of the customer who performed the action in your system. Required if no customer_email is passed.
  - `action_name` string, required — The name of the action that was performed. This must match the name set for one of your custom action earning rules.
  - `ip_address` string — The ip address of the user when the action was performed. This is required if this action completes a referral program requirement.
  - `user_agent` string — The browser user agent of the user when the action was performed. This is strongly recommended if this action completes a referral program requirements.
  - `created_at` string — The time the action was performed. This will default to the current time. Use this if you need to back date an action.
  - `reward_points` string — Use this to override the normal amount of points awarded for performing the action. Will default to the earning rule settings otherwise.
  - `history_title` string — Use this to override the normal description shown to the user in their history. Will default to the earning rule settings otherwise.

## Response `200`

200

- object

## Other responses

- `400` — 400

---

[API](https://skmtc.dev/yotpo/apis/app-developer-api.md) · [All operations](https://skmtc.dev/yotpo/apis/app-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/yotpo/app-developer-api/revisions/4effe7674a3b/schema)