---
title: "Create User Wallet Event"
description: "Use POST /users/{user_id}/wallets/{wallet_id}/events to create a manual wallet movement."
canonical: https://docs.ordering.co/api-reference/guides/create-event-by-user/
---

# Create User Wallet Event

> **API operation:** [Open the endpoint in the API reference](https://docs.ordering.co/api-reference/#tag/users/POST/users/{user_id}/wallets/{wallet_id}/events)

Use `POST /users/{user_id}/wallets/{wallet_id}/events` to create a manual wallet movement. The current public operation is `WalletEvent.register`.

If available, the operation requires administrator authentication. `amount` is required and can be positive or negative; `description` is optional. The wallet must belong to the selected user, be enabled by project settings, and not be locked. A successful movement changes the wallet balance and records the authenticated author and audit fingerprint.

Wallet movements affect stored value. Validate authorization, amount, currency/value type, and business intent before use. See [Wallet event model](https://docs.ordering.co/api-reference/guides/wallet-event-model/).

## OpenAPI reference

**Operation:** `POST /users/{user_id}/wallets/{wallet_id}/events`

**Path parameters**

| Name        | Type    | Required | Description |
| ----------- | ------- | -------- | ----------- |
| `user_id`   | integer | Yes      | —           |
| `wallet_id` | integer | Yes      | —           |

**Header parameters**

| Name                   | Type   | Required | Description |
| ---------------------- | ------ | -------- | ----------- |
| `User-Agent`           | string | No       | —           |
| `X-Forwarded-For`      | string | No       | —           |
| `X-Internal-Product-X` | string | No       | —           |

**Request body fields**

| Name          | Type   | Required |
| ------------- | ------ | -------- |
| `amount`      | number | Yes      |
| `description` | any    | No       |

**Responses**

| Code | Description                           |
| ---- | ------------------------------------- |
| 200  | OK (Envelope)                         |
| 400  | Bad Request (ErrorResponse)           |
| 401  | Unauthorized                          |
| 404  | Not Found                             |
| 429  | Too Many Requests (ErrorResponse)     |
| 500  | Internal Server Error (ErrorResponse) |
| 503  | Service Unavailable (ErrorResponse)   |

[Open this operation in the API reference](https://docs.ordering.co/api-reference/#tag/users/POST/users/{user_id}/wallets/{wallet_id}/events)