Skip to main content
POST
/
api
/
v1
/
csp
/
account
Create Account
curl --request POST \
  --url https://sandbox.api.paylias.xyz/gateway/api/v1/csp/account \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'idempotency-key: <idempotency-key>' \
  --header 'x-partner-id: <x-partner-id>' \
  --data '{
  "account_number": "1234567890123456",
  "account_title": "John Doe",
  "routing_number": "123456789",
  "type": "AT_Checkings"
}'
{
  "data": {
    "account_title": "John Doe",
    "created_at": {
      "seconds": 1635784800
    },
    "masked_account_number": "XXXX-XXXX-XXXX-1234",
    "partner_id": "part_123456789",
    "routing_number": "123456789",
    "status": "active",
    "token": "acct_123456789",
    "type": "checking",
    "updated_at": {
      "seconds": 1635788400
    },
    "institution": {
      "address": {
        "address": "123 Main St",
        "city": "New York",
        "postal_code": "10001",
        "state": "NY"
      },
      "name": "Example Bank",
      "phone_number": "+1234567890",
      "routing_number": "123456789"
    }
  },
  "ok": true
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
x-partner-id
string
default:""
required

The Partner ID header used for authorization

​
idempotency-key
string
default:""
required

The Idempotency Key - usually a UUID

Body

application/json

Request to create a new account

​
account_number
string
required

Account number

Example:

"1234567890123456"

​
account_title
string
required

Title of the account

Example:

"John Doe"

​
routing_number
string
required

Routing number of the account

Example:

"123456789"

​
type
enum<string>
required

Type of the account

Available options:
AT_Checkings,
AT_Savings
Example:

"AT_Checkings"

Response

Response when retrieving an account

Standard response structure for successful operations

​
ok
boolean

Indicates if the operation was successful

Example:

true

​
data
object

Contains the response data Account information

⌘I