Create a bank account

POST /bankaccounts

Create a new bank account record with specified details including account number, BIC, type, name, owner details, and optional initial balance information.

Headers

Authorization string Required

Authorization header

application/json

Body Required

Request model for creating a new bank account

number string

The account number of the bank account.
bic string

The Business Identifier Codes (BIC) for the bank that manages the bank account.
type string
The type of the bank account, which is one of the following:
- bban: Basic Bank Account Number is a country-specific bank account number format.
- iban: International Bank Account Number format.
Values are bban or iban.
name string

A user-defined name of the bank account, as it is shown in 24SevenOffice.
owner object

Details for the bank account owner.
Hide owner attributes Show owner attributes object
- name string Required
  
  The company name of the bank account owner.
- organizationNumber string Required
  
  The organization number of the bank account owner.
- contact object Required
  
  Details for the contact person for the bank account owner.
  Hide contact attributes Show contact attributes object
  
  name string Required
  
  The name of the contact person.
  
  email string(email) Required
  
  The email of the contact person.
transactionType object

The transaction type within the 24SevenOffice accounting module, used when posting bank transactions in the 24SevenOffice bank module. Transaction types can be retrieved from the separate /transactiontypes endpoint.
Hide transactionType attribute Show transactionType attribute object
- number number Required
  
  A unique number representing the transaction type.
ledgerAccount object

The ledger account within the 24SevenOffice accounting module that corresponds to this bank account. Accounts can be retrieved from the separate /accounts endpoint.
Hide ledgerAccount attribute Show ledgerAccount attribute object
- number number Required
  
  The unique number that indicates which type of account it belongs to.

Responses

201 application/json

Created
Hide headers attributes Show headers attributes
- Access-Control-Allow-Origin string
- Access-Control-Allow-Credentials string
- X-Trace-Id string
Hide response attributes Show response attributes object
Response model for a bank account
- id string(uuid) Required
  
  A unique identifier for the bank account within 24SevenOffice.
- number string
  
  The account number of the bank account.
- bic string
  
  The Business Identifier Codes (BIC) for the bank that manages the bank account.
- type string
  
  The type of the bank account, which is one of the following:
  
  bban: Basic Bank Account Number is a country-specific bank account number format.
  
  iban: International Bank Account Number format.
  
  Values are bban or iban.
- name string
  
  A user-defined name of the bank account, as it is shown in 24SevenOffice.
- owner object
  
  Details for the bank account owner.
  
  Hide owner attributes Show owner attributes object
  
  name string Required
  
  The company name of the bank account owner.
  
  organizationNumber string Required
  
  The organization number of the bank account owner.
  
  contact object Required
  
  Details for the contact person for the bank account owner.
  
  Hide contact attributes Show contact attributes object
  
  name string Required
  
  The name of the contact person.
  
  email string(email) Required
  
  The email of the contact person.
- transactionType object
  
  The transaction type within the 24SevenOffice accounting module, used when posting bank transactions in the 24SevenOffice bank module. Transaction types can be retrieved from the separate /transactiontypes endpoint.
  
  Hide transactionType attribute Show transactionType attribute object
  
  number number Required
  
  A unique number representing the transaction type.
- ledgerAccount object
  
  The ledger account within the 24SevenOffice accounting module that corresponds to this bank account. Accounts can be retrieved from the separate /accounts endpoint.
  
  Hide ledgerAccount attribute Show ledgerAccount attribute object
  
  number number Required
  
  The unique number that indicates which type of account it belongs to.
- balance object
  
  The balance of the bank account. The whole balance object is omitted if no balance is available.
  
  Hide balance attributes Show balance attributes object
  
  amount number
  
  The amount of the balance.
  
  timestamp string(date-time)
  
  The timestamp of the balance.
  
  currency object
  
  The currency of the balance.
  
  Hide currency attribute Show currency attribute object
  
  code string Required
  
  The currency code of the balance.
- createdAt string(date-time) Required
  
  A timestamp for when a record was created, in ISO 8601 format.
- modifiedAt string(date-time) Required
  
  A timestamp for when one of the properties of a record was last modified, in ISO 8601 format. The Bank Account Balance changes are not included here, as these are defined by a separate "timestamp" property for the balance object.

POST /bankaccounts

curl \
 --request POST 'https://rest.api.24sevenoffice.com/v1/bankaccounts' \
 --header "Content-Type: application/json" \
 --header "Authorization: string" \
 --data '{"number":"90000000001","bic":"DNBANOKKXXX","type":"bban","name":"ABC bank account","owner":{"name":"ABC Corporation","organizationNumber":"123456789","contact":{"name":"John Doe","email":"doe@example.com"}},"transactionType":{"number":5},"ledgerAccount":{"number":1920}}'

Request examples

# Headers
Authorization: string

# Payload
{
  "number": "90000000001",
  "bic": "DNBANOKKXXX",
  "type": "bban",
  "name": "ABC bank account",
  "owner": {
    "name": "ABC Corporation",
    "organizationNumber": "123456789",
    "contact": {
      "name": "John Doe",
      "email": "doe@example.com"
    }
  },
  "transactionType": {
    "number": 5
  },
  "ledgerAccount": {
    "number": 1920
  }
}

Response examples (201)

[
  {
    "id": "123-456-789",
    "bic": "DNBANOKKXXX",
    "name": "ABC bank account",
    "type": "bban",
    "owner": {
      "name": "ABC Corporation",
      "contact": {
        "name": "John Doe",
        "email": "doe@example.com"
      },
      "organizationNumber": "123456789"
    },
    "number": "90000000001",
    "createdAt": "2022-01-01T18:00:00.000Z",
    "modifiedAt": "2022-01-01T18:00:00.000Z",
    "ledgerAccount": {
      "number": 1920
    },
    "transactionType": {
      "number": 5
    }
  }
]