---
title: "Create a points transaction"
method: POST
path: "/points_transactions"
tags: ["Points Transactions"]
---

# Create a points transaction

`POST /points_transactions`

Add or remove points from a customer's points balance by creating a points transaction.

## Request body

- object
  - `points_transaction` object, required
    - `customer_id` integer, required — The ID of the customer whose balance this points transaction applies to.
    - `points_change` integer, required — The number of points added or removed from the customer's points balance. The value is positive if points were added to the customer's balance and negative if points were deducted.
    - `description` string — A message visible to the customer that describes the reason for the points change.
    - `internal_note` string — A note that is visible to the merchant. This note should never be visible to customers.

## Response `201`

The points transaction was successfully created.

- object
  - `points_transaction` PointsTransaction
    - `id` integer — Unique identifier for the points transaction.
    - `customer_id` integer — The ID of the customer whose balance this points transaction applies to.
    - `points_change` integer — The number of points added or removed from the customer's points balance. The value is positive if points were added to the customer's balance and negative if points were deducted.
    - `description` string — A message visible to the customer that describes the reason for the points change.
    - `internal_note` string, nullable — A note that is visible to the merchant. This note should never be visible to customers.
    - `created_at` string, date-time — The date and time when the points transaction was created.
    - `updated_at` string, date-time — The date and time when the points transaction was last updated.

---

[API](https://skmtc.dev/smile/apis/smile-io-rest-api.md) · [All operations](https://skmtc.dev/smile/apis/smile-io-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smile/smile-io-rest-api/revisions/081bc804c5df/schema)