Kobble
  1. Beneficiaries
Kobble
  • Introduction
  • Authorization
    • Authorization
    • Get access token
      POST
  • Beneficiaries
    • List all beneficiaries
      GET
    • Get beneficiary by ID
      GET
    • Create beneficiary
      POST
    • Update beneficiary
      PUT
  • Cards
    • Cards API
    • Get all cards
      GET
    • Create a new card
      POST
    • Get card by ID
      GET
    • Update card status
      PATCH
    • Replace or renew card
      POST
    • Generate card secret
      POST
  • Card Programs
    • Card Programs API
    • Get all programs
      GET
    • Create a new program
      POST
    • Get program by ID
      GET
  • Clients
    • Clients API
    • Get all clients
      GET
    • Get client by ID
      GET
    • Create a new client
      POST
    • Update client status
      PATCH
  • Endusers
    • Endusers API
    • Get all endusers
      GET
    • Create a new enduser
      POST
    • Get enduser by ID
      GET
  • Transactions
    • Transactions API
    • Get all transactions
    • Create a transaction
    • Get transaction by ID
    • Create manual credit transaction
    • Create manual debit transaction
  • Wallets
    • Wallets API
    • Get all wallets
    • Create a new wallet
    • Get wallet by ID
    • Update wallet
  • Relays
    • Relays API
    • Create subscription
  • Webhooks
    • Webhooks API
    • Get all webhooks
    • Create a webhook
    • Delete a webhook
  1. Beneficiaries

Create beneficiary

POST
/customers/v1/beneficiaries

Request

Body Params application/json
bank_name
string 
required
bank_country
string <char>
required
ISO 3166-1 Alpha-3 Country Code
>= 3 characters<= 3 characters
Example:
SGP
Match pattern:
^[A-Z]{3}$
bank_code_type
enum<string> 
required
Allowed values:
BSBBPAYROUTING_NUMBERSORT_CODE
bank_code
string 
required
account_number
string 
required
person
object 
optional
name
string 
required
company
object 
optional
name
string 
required
metadata
object 
optional
Example
{
    "bank_name": "Westpac",
    "bank_country": "AUS",
    "bank_code_type": "BSB",
    "bank_code": "111-111",
    "account_number": "05293193",
    "person": {
        "name": "Mike Smith"
    },
    "metadata": {}
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/customers/v1/beneficiaries' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bank_name": "Westpac",
    "bank_country": "AUS",
    "bank_code_type": "BSB",
    "bank_code": "111-111",
    "account_number": "05293193",
    "person": {
        "name": "Mike Smith"
    },
    "metadata": {}
}'

Responses

🟢200Success
application/json
Body
object {0}
Example
{}
Previous
Get beneficiary by ID
Next
Update beneficiary
Built with