Skip to main content
POST
Create a destination

Authorizations

X-API-Key
string
header
required

User API key authentication. Create a key under Settings → API keys in the Slash dashboard (https://app.slash.com/global-settings/api-keys) and send the x-legal-entity header naming the legal entity to act on with every request. Keys scoped to a legal entity are rejected with 403 user_api_key_required.

Headers

X-Idempotency-Key
string
required

Unique caller-generated key for one create request. Once an authenticated, schema-valid request reaches the operation, the key is permanently consumed for that operation and legal entity whether the operation succeeds or fails. Reusing it in that scope returns 409 and never replays a response, unlike API v1, which replays the original response for a matching key.

Required string length: 1 - 255

The legal entity to act on. Required on every request; a user API key can act on any legal entity its user has access to.

Pattern: ^le_[a-zA-Z0-9]+$

Body

application/json

Save US routing and account details for ACH, wire, or realtime payments.

contactId
string
required

Contact id with the le_c_ prefix.

type
enum<string>
required
Available options:
bank_account
name
string
required
Required string length: 1 - 255
accountNumber
string
required
Required string length: 1 - 34
routingNumber
string
required
Pattern: ^[0-9]{9}$
accountType
enum<string>
required
Available options:
checking,
savings
beneficiary
object
required

Response

The created destination.

US routing and account details usable for ACH, wire, or realtime payments.

id
string
required

Destination id with the le_contact_destination_ prefix.

contactId
string
required

Contact that owns this destination.

name
string
required

Display name visible to your organization.

status
enum<string>
required
Available options:
active,
pending,
disabled,
archived
supportedTransferTypes
enum<string>[]
required
Available options:
ach,
wire,
realtime,
international_wire
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
type
enum<string>
required
Available options:
bank_account
bankAccount
object
required
disabledReason
string
archivedAt
string<date-time>