---
title: "Store user attributes"
method: POST
path: "/payout/attribute/{user_token}/{destination_token}/{currency}"
tags: ["Attribute"]
deprecated: true
---

# Store user attributes

`POST /payout/attribute/{user_token}/{destination_token}/{currency}`

## Request

- Base URL: `https://api.masspay.io/v1.0.0`
- URL: `https://api.masspay.io/v1.0.0/payout/attribute/{user_token}/{destination_token}/{currency}`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/masspay/apis/masspay-api/docs/payout/attribute/:user_token/:destination_token/:currency/post.ts> (a function with typed inputs; its response is checked against the schema)

> **Deprecated.**

This **POST** endpoint is used to store user attributes, allowing you to associate additional data with a user token. <br> To use this endpoint, you need to provide the `user_token`, `destination_token`, and `currency` as parameters in the URL Path. You also need to provide the attribute values as JSON parameters in the Request body. <br> If existing attributes are already stored for the user, this call will override their values.

## Path parameters

- `user_token` string, required
- `destination_token` string, required

## Headers

- `Idempotency-Key` string

## Request body

- AttrTxn
  - `values` AttrValue[], required
    - `token` string, required: The token that represents the attribute that needs to be updated.
    - `value` string, required: The value that needs to be stored for the associated token
  - `attr_set_token` string: The token that represents a set of attributes for a specific payer. Optional, specify the value if you're trying to add a value for a specific attributes set. If the existing values associated with the attr_set_token are different, this value will be ignored and a new attr_set_token would be issued.
  - `label` string: Optional user-defined label for identifying or naming this set of attributes. Useful for UI display or future reference.

## Response `201`

Succesfully created.

- object
  - `attr_set_token` string, required: `attr_set_token` associated with the stored attributes

## Other responses

- `400`: Bad request.
- `401`: Unauthorized.
- `403`: Forbidden.
- `404`: Not found.
- `405`: Method Not Allowed.
- `500`: Internal server error.
- `504`: Gateway Time-out.

## Changes

- **2026-11-03** `f9fa41b7c45c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/masspay/apis/masspay-api/changes/payout/attribute/:user_token/:destination_token/:currency/post.md)

---

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