---
title: "Agregar puntos de lealtad a un cliente"
method: POST
path: "/royalty/justo-coins/add"
---

# Agregar puntos de lealtad a un cliente

`POST /royalty/justo-coins/add`

## Request

- Base URL: `https://api.service.getjusto.com/v3`
- URL: `https://api.service.getjusto.com/v3/royalty/justo-coins/add`
- Auth: HTTP bearer

Agrega puntos de lealtad (Justo Coins) a un cliente específico. Requiere autorización de administrador.

## Request body

- object
  - `amount` number, required: Cantidad de puntos de lealtad a agregar (debe ser un número positivo)
  - `userId` string, required: ID del usuario de Justo al que se le agregarán los puntos
  - `expiresAt` string, date-time, nullable: Fecha de expiración de los puntos (opcional)

## Response `200`

Puntos de lealtad agregados exitosamente

- object
  - `success` boolean: Operación exitosa
  - `data` object, required
    - `amount` number, required: Cantidad de puntos agregados
    - `websiteId` string, required: ID del sitio web donde se realizó la transacción
    - `date` string, date-time, required: Fecha y hora de la transacción
    - `balance` number, required: Balance total de puntos después de la transacción
    - `user` object, required
      - `clientId` string, required: ID del cliente
      - `email` string, required: Email del cliente
      - `fullName` string, required: Nombre completo del cliente
      - `phone` string, required: Teléfono del cliente

## Other responses

- `400`: Error de validación - datos inválidos o faltantes
- `401`: No autorizado - token de autenticación inválido o ausente
- `404`: Usuario no encontrado en el sitio web especificado
- `500`: Error interno del servidor - fallo en la transacción

## Changes

- **2025-10-21** `b943a476e1fb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getjusto/apis/justo-api/changes/royalty/justo-coins/add/post.md)

---

[API](https://skmtc.dev/getjusto/apis/justo-api.md) - [All operations](https://skmtc.dev/getjusto/apis/justo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getjusto/apis/justo-api/revisions/c810bd8246fd?raw)