---
title: "Store global user attributes"
method: POST
path: "/attribute/{user_token}/global"
tags: ["Attribute"]
---

# Store global user attributes

`POST /attribute/{user_token}/global`

## Request

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

This **GET** endpoint is used to retrieve all global user attributes associated with a specific user token. <br>
You can use this endpoint to obtain the additional data that has been previously stored for a user. <br>
To use this endpoint, you need to provide the `user_token` as a parameter in the URL Path. <br>
The response will include all global attributes currently associated with the provided user token.

## Path parameters

- `user_token` string, required

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `values` GlobalAttrValue[], required
    - `token` string: Either `token` or `type` are 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
    - `type` 'PhoneNumber' | 'Gender' | 'IdentificationNumber' | 'MaidenName' | 'SocialSecurity' | 'EmploymentName' | 'EmploymentAddress' | 'EmploymentPhone' | 'EmploymentOccupation' | 'EmploymentSupervisor' | 'SecondLastName' | 'BirthCountry' | 'SourceOfFunds' | 'DateOfBirth' | 'IdentificationType' | 'IDSelfieCollection' | 'City' | 'Country' | 'IdentificationExpiration' | 'Address1' | 'PostalCode' | 'GuardianFullName' | 'GuardianGovIDType' | 'GuardianGovIDNumber' | 'GuardianConsent' | 'EIN' | 'WalletAddress' | 'OAuthGrant' | 'SecurityAnswer': Either `token` or `type` are required. The type of attribute we are storing. i.e. SocialSecurity

## Response `201`

Succesfully created.

## 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/attribute/:user_token/global/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)