Skip to main content
POST
https://api.karmapay.xyz/v0
/
v0
/
external-accounts
const response = await fetch('https://api.karmapay.xyz/v0/external-accounts', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    externalUserId: "user_123",
    accountName: "My Checking Account",
    currency: "usd",
    accountOwnerName: "John Doe",
    accountOwnerType: "individual",
    firstName: "John",
    lastName: "Doe",
    account: {
      accountNumber: "123456789",
      routingNumber: "021000021",
      checkingOrSavings: "checking"
    },
    address: {
      streetLine1: "123 Main St",
      city: "New York",
      state: "NY",
      postalCode: "10001",
      country: "USA"
    }
  }),
});

{
  "data": {
    "id": "ext_abc123",
    "accountName": "My Checking Account",
    "currency": "usd",
    "last4": "6789"
  }
}
Authentication: Business API Key
Create an external bank account where fiat funds can be sent after crypto liquidation.

​
Request Body

​
externalUserId
string
required
Your internal user ID
​
accountName
string
required
Account name/label
​
currency
string
required
usd or eur
​
accountOwnerName
string
required
Account owner’s full name
​
accountOwnerType
string
required
individual or business

​
For USD Accounts

​
firstName
string
First name (for individual owners)
​
lastName
string
Last name (for individual owners)
​
account
object
​
address
object

​
For EUR Accounts

​
iban
object
const response = await fetch('https://api.karmapay.xyz/v0/external-accounts', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    externalUserId: "user_123",
    accountName: "My Checking Account",
    currency: "usd",
    accountOwnerName: "John Doe",
    accountOwnerType: "individual",
    firstName: "John",
    lastName: "Doe",
    account: {
      accountNumber: "123456789",
      routingNumber: "021000021",
      checkingOrSavings: "checking"
    },
    address: {
      streetLine1: "123 Main St",
      city: "New York",
      state: "NY",
      postalCode: "10001",
      country: "USA"
    }
  }),
});

{
  "data": {
    "id": "ext_abc123",
    "accountName": "My Checking Account",
    "currency": "usd",
    "last4": "6789"
  }
}