---
title: "Bulk Update Store Credits"
method: POST
path: "/user_credits/bulk_update"
tags: ["Store Credits"]
---

# Bulk Update Store Credits

`POST /user_credits/bulk_update`

Bulk update multiple user store credit records. <br> 批量更新多個 users 購物金

## Request body

- object
  - `user_ids` string[], required — List of user IDs to update. <br> user ID 的列表，指定要更新的 user
  - `value` number, required — The value to set for each user's store credit. <br> 要給予每個 user 的購物金金額
  - `remarks` string, required — Remarks for the store credits update. <br> 購物金更新的備註
  - `performer_id` string — The User ID of the performer making the update. Optional. <br> 執行者 User ID
  - `expired_at` string, date-time — Expiration date for the store credits. <br> 購物金的過期日期
  - `email_target` 1 | 3 — Allowed 1 & 3. 1 means not send, 3 means send all. <br> 電子郵件是否發送，1為不發送，3為發送
  - `sms_notification_target` 1 | 2 | 3 — Allowed 1~3. 1 means not send, 2 means send with verified, 3 means send all. <br> 簡訊是否發送通知，1為不發送，2為發送至驗證手機，3為全部發送
  - `include_blacklisted` boolean — Whether to include blacklisted (login/order-banned, status=blacklisted) customers as recipients. Default false. <br> 是否將黑名單（禁止登入下單，status=blacklisted）顧客納入發放對象，預設 false

## Response `200`

Successfully updated the store credits. <br> 成功更新購物金記錄

- object
  - `message` string
  - `job_id` string

## Other responses

- `422` — Unprocessable entity error
- `500` — Server error

---

[API](https://skmtc.net/shoplineapp/apis/shopline-open-api.md) · [All operations](https://skmtc.net/shoplineapp/apis/shopline-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shoplineapp/shopline-open-api/versions/1675ac12cde7/schema)