curl --request POST \
--url https://api.enterprise.sandbox.uphold.com/core/external-accounts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "bank",
"asset": "USD",
"network": "ach",
"label": "My ACH Bank Account",
"address": {
"country": "US",
"subdivision": "US-CA",
"city": "San Francisco",
"line1": "123 Main Street",
"line2": "Apt 4B",
"postalCode": "94102"
},
"routingNumber": "121000248",
"accountNumber": "9876543210",
"accountType": "checking"
}
'{
"externalAccount": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"ownerId": "1e32fca3-23f7-40ed-bc1b-de10c790182d",
"type": "bank",
"status": "ok",
"label": "My ACH Bank Account",
"asset": "USD",
"network": "ach",
"features": [
"withdraw"
],
"details": {
"address": {
"country": "US",
"subdivision": "US-CA",
"city": "San Francisco",
"line1": "123 Main Street",
"line2": "Apt 4B",
"postalCode": "94102"
},
"routingNumber": "121000248",
"accountNumber": "9876543210",
"accountType": "checking",
"secondaryNetworks": {
"withdraw": [
"fednow"
]
}
},
"createdAt": "2024-06-01T00:00:00.000Z",
"updatedAt": "2024-07-15T00:00:00.000Z"
}
}External accounts
Create external account
Create an external account for the user.
POST
/
core
/
external-accounts
curl --request POST \
--url https://api.enterprise.sandbox.uphold.com/core/external-accounts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "bank",
"asset": "USD",
"network": "ach",
"label": "My ACH Bank Account",
"address": {
"country": "US",
"subdivision": "US-CA",
"city": "San Francisco",
"line1": "123 Main Street",
"line2": "Apt 4B",
"postalCode": "94102"
},
"routingNumber": "121000248",
"accountNumber": "9876543210",
"accountType": "checking"
}
'{
"externalAccount": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"ownerId": "1e32fca3-23f7-40ed-bc1b-de10c790182d",
"type": "bank",
"status": "ok",
"label": "My ACH Bank Account",
"asset": "USD",
"network": "ach",
"features": [
"withdraw"
],
"details": {
"address": {
"country": "US",
"subdivision": "US-CA",
"city": "San Francisco",
"line1": "123 Main Street",
"line2": "Apt 4B",
"postalCode": "94102"
},
"routingNumber": "121000248",
"accountNumber": "9876543210",
"accountType": "checking",
"secondaryNetworks": {
"withdraw": [
"fednow"
]
}
},
"createdAt": "2024-06-01T00:00:00.000Z",
"updatedAt": "2024-07-15T00:00:00.000Z"
}
}Creating a
card external account sends the full card number and security code through your systems, which requires your organization to be PCI DSS compliant. If it isn’t, link cards through the Payment Widget, which collects the card details itself, with its Transaction - Select Deposit Origin or Transaction - Select Withdrawal Destination flow.metadata field to store your own business data (e.g., cardholder name, tracking information, custom labels). If not provided during creation, you can add it later using Set metadata.Body
application/json
- Card
- Bank (ACH)
- Crypto
Was this page helpful?