Create an API account
Creates the per-token balance your integration spends from. You need one API account per token you plan to pay out in.
POST
https://api-prod.useknit.io/api/v1/business-api-services-wallets
⚠️
This creates the account with a zero balance — it does not move any money.
Fund it from the dashboard by transferring from your business wallet, or let
collections and
wallet deposits credit it. Payouts fail with 400
until there is enough balance.
Body
tokenstringrequired
The token this account holds. One of USDT or USDC.
Request
cURL
curl -X POST "https://api-prod.useknit.io/api/v1/business-api-services-wallets" \
-H "Authorization: Bearer $KNIT_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "token": "USDT" }'Response
Returns 201 with the new account.
201 Created
{
"statusCode": 201,
"message": "Payout wallet created successfully",
"data": {
"id": "c7ddb254-5da1-4136-b19e-733a00a31c70",
"businessId": "a2667393-2c6c-43c9-a288-6167e2b2b591",
"token": "USDT",
"amount": "0",
"createdAt": "2024-02-22T14:16:23.000000Z",
"updatedAt": "2024-02-22T14:16:23.000000Z"
},
"success": true
}Errors
| Status | Cause |
|---|---|
401 | Missing or invalid token, IP not allow-listed, or missing payout-wallets:write |
409 | An API account already exists for that token — fetch it with List API accounts instead |
400 | token is missing or is not USDT or USDC |
Creating accounts is idempotent in practice: a 409 means the account you
wanted already exists, so it is safe to treat as success and read the
existing account.
