Skip to main content
POST

Authorizations

Authorization
string
header
required

An access token (at_test_… or at_live_…) from POST https://idp.talescria.com/oauth/token.

Headers

Idempotency-Key
string
required

A unique key for this operation. Send the same key when you retry it. Kept for 24 hours.

Required string length: 8 - 255
Pattern: ^[A-Za-z0-9_\-:.]+$

Body

application/json
name
string
required

Your name for it. Required, because several accounts may share a currency and this is the only thing telling them apart.

Maximum string length: 100
currency
enum<string>
required

Case-insensitive; trimmed and upper-cased before use.

Available options:
USD,
EUR,
GBP,
NGN,
KES,
ZAR,
GHS
accountType
enum<string>
default:operational

What the account is for. Optional: omitted, it is operational. An unrecognised value is a 400 rather than a silent default, for example savings.

Available options:
checking,
debit,
operational,
safeguard

Response

Opened. The balance is zero by construction.

account
object