---
title: "Transfer credits to another account"
method: POST
path: "/credit/transfer"
tags: ["Credits"]
---

# Transfer credits to another account

`POST /credit/transfer`

Before you can use the transfer credits endpoint, the _credit-transfer facility_ must be activated for your account.  You can request activation from `support@bulksms.com`. 

The recipient must be an enabled account that uses the same currency as your account.

## Request body

- TransferEntry
  - `toUsername` string, required — The username of the account that will receive the credits.
  - `toUserId` number, required — The numeric user ID of the account that will receive the credits. The ID must match the username.
  - `credits` number, required — The amount of credits to transfer.
  - `commentOnFrom` string — An optional note that will be shown on the credit history of your account. The maximum length of the comment is 100.
  - `commentOnTo` string — An optional note that will be shown on the credit history of the recipient's account. The maximum length of the comment is 100.

## Response `200`

An empty body when the credits were transferred OK.

## Other responses

- `400` — When the request fails validation checks.
- `403` — When there are not enough credits in your account or the credit transfer facility is not activated.

---

[API](https://skmtc.net/bulksms/apis/bulksms-json-rest-api.md) · [All operations](https://skmtc.net/bulksms/apis/bulksms-json-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bulksms/bulksms-json-rest-api/versions/f923d2ecca43/schema)