Skip to main content
POST
/
white-label
/
transfer
Transfer balance
curl --request POST \
  --url https://app.autocalls.ai/api/white-label/transfer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "user_id": 123,
  "email": "<string>",
  "transfer_type": "<string>",
  "operation": "<string>",
  "amount": 123
}
'
{
  "message": "Transfer completed successfully.",
  "transfer": {
    "type": "minutes",
    "operation": "add",
    "amount": 100
  },
  "user": {
    "id": 123,
    "email": "user@example.com",
    "name": "John Doe",
    "minutes_balance": 150.5,
    "credits_balance": 0
  },
  "your_balance": {
    "minutes": 850.5
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.autocalls.ai/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint allows white label admins to transfer call minutes or chat credits to and from their users. This is useful for managing user balances programmatically when building custom frontends.
This endpoint is only available for white label admins. Regular users will receive a 403 Forbidden error.

​
Request Body

​
user_id
integer
The ID of the user to transfer to/from. Required if email is not provided.
​
email
string
The email of the user to transfer to/from. Required if user_id is not provided.
​
transfer_type
string
required
The type of balance to transfer: minutes or credits
​
operation
string
required
The operation to perform: add (transfer to user) or remove (transfer from user)
​
amount
number
required
The amount to transfer. For minutes, this is the number of call minutes. For credits, this is the number of chat credits.

​
Response

​
message
string
Success message
​
transfer
object
Details of the transfer
​
user
object
The user’s updated balance information
​
your_balance
object
Your (tenant owner’s) updated balance
{
  "message": "Transfer completed successfully.",
  "transfer": {
    "type": "minutes",
    "operation": "add",
    "amount": 100
  },
  "user": {
    "id": 123,
    "email": "user@example.com",
    "name": "John Doe",
    "minutes_balance": 150.5,
    "credits_balance": 0
  },
  "your_balance": {
    "minutes": 850.5
  }
}

​
Transfer Types

TypeDescriptionConversion
minutesCall minutes for AI phone callsDirect 1:1 transfer
creditsChat credits for AI chat, WhatsApp, SMS9 credits = 1 minute

​
Operations

OperationMinutes BehaviorCredits Behavior
addDeducts from your balance, adds to userDeducts minutes from you (at 9 credits/min), adds credits to user
removeDeducts from user, adds to your balanceDeducts credits from user, adds minutes to you

​
Example: Adding Credits to a User

curl -X POST https://app.autocalls.ai/api/white-label/transfer \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "transfer_type": "credits",
    "operation": "add",
    "amount": 100
  }'

​
Example: Removing Minutes from a User

curl -X POST https://app.autocalls.ai/api/white-label/transfer \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": 123,
    "transfer_type": "minutes",
    "operation": "remove",
    "amount": 50
  }'