Skip to main content
POST
https://api.mpcvault.com
/
v1
/
createBatchPayment
curl -X POST https://api.mpcvault.com/v1/createBatchPayment \
  -H "Content-Type: application/json" \
  -H "x-mtoken: YOUR_API_TOKEN" \
  -d '{
    "name": "January Payroll",
    "notes": "Monthly salary distribution",
    "type": {
      "evmBatchSendNative": {
        "walletUuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "chainId": "1",
        "recipients": [
          {"to": "0xabc123...", "value": "1000000000000000000"},
          {"to": "0xdef456...", "value": "1500000000000000000"}
        ]
      }
    }
  }'

{
  "batchPayment": {
    "uuid": "c3d4e5f6-a7b8-9012-cdef-gh3456789012",
    "name": "January Payroll",
    "status": "PENDING",
    "createdAt": "2024-01-15T10:30:00Z"
  }
}
Creates a batch payment that allows you to send tokens to multiple recipients in a single operation. You will need to complete the batch payment using the MPCVault web app.

​
Headers

​
x-mtoken
string
required
Your API token

​
Body

​
name
string
Name of the batch payment
​
notes
string
Transaction notes for the batch payment
​
type
object
required
Batch payment type. See batch types below.

​
Batch Payment Types

TypeFields
evmBatchSendNativewalletUuid, chainId, recipients (array of {to, value} in wei)
evmBatchSendERC20walletUuid, chainId, contractAddress, recipients (array of {to, value})
btcBatchSendNativewalletUuid, recipients (array of {to, value} in satoshis)
suiBatchSendNativewalletUuid, recipients (array of {to, value})
suiBatchSendCoinwalletUuid, coinType, recipients (array of {to, value})

​
Response

​
batchPayment
object
The created batch payment
​
error
object
Error details (if failed)
curl -X POST https://api.mpcvault.com/v1/createBatchPayment \
  -H "Content-Type: application/json" \
  -H "x-mtoken: YOUR_API_TOKEN" \
  -d '{
    "name": "January Payroll",
    "notes": "Monthly salary distribution",
    "type": {
      "evmBatchSendNative": {
        "walletUuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "chainId": "1",
        "recipients": [
          {"to": "0xabc123...", "value": "1000000000000000000"},
          {"to": "0xdef456...", "value": "1500000000000000000"}
        ]
      }
    }
  }'

{
  "batchPayment": {
    "uuid": "c3d4e5f6-a7b8-9012-cdef-gh3456789012",
    "name": "January Payroll",
    "status": "PENDING",
    "createdAt": "2024-01-15T10:30:00Z"
  }
}