---
title: "Create a customer credits account"
method: POST
path: "/v1/customer-credits/accounts"
tags: ["Customer Credits - Accounts (Experimental)"]
---

# Create a customer credits account

`POST /v1/customer-credits/accounts`

Create a new credits account for a customer. Optionally seed it with an initial balance.

## Request body

- CreateAccountDto
  - `name` string — Human-readable name for the account
  - `customer_id` string, required — The owner ID this account belongs to (e.g. customer ID)
  - `unit_label` string — Label for the unit of currency/credits
  - `initial_balance` string — Seed the account with this many credits on creation

## Response `201`

Account created

- AccountResponseDto
  - `id` string, required — Account ID
  - `store_id` string, required — Store ID
  - `customer_id` string, required — Owner ID
  - `name` string, required — Account name
  - `unit_label` string, required — Unit label
  - `status` 'active' | 'frozen' | 'closed', required — Account status
  - `created_at` string, required — Creation timestamp
  - `updated_at` string, required — Last update timestamp

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Invalid or missing API key
- `404` — Not Found - Resource does not exist

---

[API](https://skmtc.net/creem/apis/creem-api.md) · [All operations](https://skmtc.net/creem/apis/creem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/creem/creem-api/revisions/aa593160d96c/schema)