POST `/admin/points`

Create a points account for the user under the current tenant. A user can only have one points account under the same tenant.

Points Service `bearerAuth` application/json

Request Body

Schema: dto.CreatePointAccountRequest

Field	Type	Required	Example	Constraints	Description
`user_id`	`string`	Yes

Responses

Status	Description	Schema
201	Points account created successfully	`dto.PointAccountDetailResponse`
400	Bad request	`gitee_com_autional_base_dto.SimpleResponse`
401	Unauthorized	`gitee_com_autional_base_dto.SimpleResponse`
403	Forbidden	`gitee_com_autional_base_dto.SimpleResponse`
404	Resource not found	`gitee_com_autional_base_dto.SimpleResponse`
409	Account already exists	`gitee_com_autional_base_dto.SimpleResponse`
500	Internal server error	`gitee_com_autional_base_dto.SimpleResponse`

Referenced Schemas

dto.PointAccountDetailResponse

Field	Type	Required	Example	Constraints	Description
`code`	`integer`	No
`data`	`dto.PointAccountResponse`	No
`message`	`string`	No
`timestamp`	`string`	No

dto.PointAccountResponse

Field	Type	Required	Example	Constraints	Description
`balance`	`integer`	No	`1500`
`created_at`	`string`	No	`2026-01-15T10:30:00Z`
`exchange_rate`	`integer`	No	`100`
`expired_points`	`integer`	No	`100`
`frozen_balance`	`integer`	No	`200`
`id`	`string`	No	`01ARZ3NDEKTSV4RRFFQ69G5FAV`
`points_type`	`string`	No	`cash_equivalent`
`status`	`string`	No	`active`
`tenant_id`	`string`	No	`tnt_example_001`
`total_earned`	`integer`	No	`5000`
`total_spent`	`integer`	No	`3500`
`updated_at`	`string`	No	`2026-04-10T14:20:00Z`
`user_id`	`string`	No	`usr_example_001`
`version`	`integer`	No	`3`

gitee_com_autional_base_dto.SimpleResponse

Field	Type	Required	Example	Constraints	Description
`code`	`integer`	No
`message`	`string`	No
`timestamp`	`string`	No

Try this API in Scalar → Download OpenAPI spec (JSON) ↓