Create an account

POST

accounts

Create an account

curl --request POST \
  --url https://api.infinity.swiss/v1/accounts \
  --header 'Content-Type: application/json' \
  --header 'x-api-token: <api-key>' \
  --data '
{
  "number": 6410,
  "name": "Electricity",
  "description": "<string>",
  "colour": "#0746c8",
  "currency": "EUR"
}
'

import requests

url = "https://api.infinity.swiss/v1/accounts"

payload = {
    "number": 6410,
    "name": "Electricity",
    "description": "<string>",
    "colour": "#0746c8",
    "currency": "EUR"
}
headers = {
    "x-api-token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    number: 6410,
    name: 'Electricity',
    description: '<string>',
    colour: '#0746c8',
    currency: 'EUR'
  })
};

fetch('https://api.infinity.swiss/v1/accounts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.infinity.swiss/v1/accounts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'number' => 6410,
    'name' => 'Electricity',
    'description' => '<string>',
    'colour' => '#0746c8',
    'currency' => 'EUR'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.infinity.swiss/v1/accounts"

	payload := strings.NewReader("{\n  \"number\": 6410,\n  \"name\": \"Electricity\",\n  \"description\": \"<string>\",\n  \"colour\": \"#0746c8\",\n  \"currency\": \"EUR\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.infinity.swiss/v1/accounts")
  .header("x-api-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"number\": 6410,\n  \"name\": \"Electricity\",\n  \"description\": \"<string>\",\n  \"colour\": \"#0746c8\",\n  \"currency\": \"EUR\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.infinity.swiss/v1/accounts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"number\": 6410,\n  \"name\": \"Electricity\",\n  \"description\": \"<string>\",\n  \"colour\": \"#0746c8\",\n  \"currency\": \"EUR\"\n}"

response = http.request(request)
puts response.read_body

{
  "account": {
    "number": 1020,
    "name": "Bank",
    "type": "assets",
    "currency": "CHF",
    "isSystemAccount": true,
    "isTaxApplicable": true,
    "description": "<string>",
    "colour": "#0746c8"
  }
}

{
  "code": "<string>",
  "invalidFields": [
    "colour"
  ]
}

{
  "code": "general/unauthorised"
}

{
  "code": "<string>"
}

{
  "code": "<string>"
}

Creating an account

Accounts are created by account number. For example, the following payload adds an expense account for electricity:

{
  "number": 6410,
  "name": "Electricity",
  "description": "Power for the workshop",
  "colour": "#0746c8"
}

The account type is inferred from the account number according to the Swiss chart of accounts for SMEs, unless you provide a type explicitly. Account numbers 1000–1999 are assets, 2000–2999 liabilities, 3000–3999 income and 4000–6999 expenses; the ranges 7000–8999 contain both income and expense accounts. The new account becomes part of the current chart of accounts: it is created in the earliest open fiscal year and carried forward into the fiscal years that follow it.

Foreign currency accounts

To create a bank account in a foreign currency, pass its currency. Foreign currency accounts are only allowed in the liquid assets range 1000–1099, and the currency must be enabled in the organisation.

Authorizations

x-api-token

string

header

required

API token for authentication. Obtain from your Infinity account settings.

Body

application/json

Provide the account to create.

number

integer

required

The four-digit account number. Must not be taken yet.

Required range: 1000 <= x <= 9999

Example:

6410

name

string

required

The name of the account.

Required string length: 1 - 100

Example:

"Electricity"

type

enum<string>

The type of the account. If omitted, the type is inferred from the account number according to the Swiss chart of accounts for SMEs (e.g. 1000–1999 are assets, 2000–2999 liabilities, 3000–3999 income, 4000–6999 expenses).

Available options:

assets,

liabilities,

income,

expense

description

string

An optional description of what is booked to this account.

Maximum string length: 500

colour

string

An optional hex colour code used to display the account in the app.

Pattern: ^#[0-9a-fA-F]{6}$

Example:

"#0746c8"

currency

string

The 3-character currency code (ISO 4217) for a foreign currency account. Only allowed for liquid assets accounts 1000–1099, and must be a currency that is enabled in the organisation. Defaults to CHF.

Required string length: 3

Example:

"EUR"

Response

The account was created successfully.

account

Account · object

required

An account of the chart of accounts. Accounts are identified by their account number.

Show child attributes

Create an account

curl --request POST \
  --url https://api.infinity.swiss/v1/accounts \
  --header 'Content-Type: application/json' \
  --header 'x-api-token: <api-key>' \
  --data '
{
  "number": 6410,
  "name": "Electricity",
  "description": "<string>",
  "colour": "#0746c8",
  "currency": "EUR"
}
'

import requests

url = "https://api.infinity.swiss/v1/accounts"

payload = {
    "number": 6410,
    "name": "Electricity",
    "description": "<string>",
    "colour": "#0746c8",
    "currency": "EUR"
}
headers = {
    "x-api-token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    number: 6410,
    name: 'Electricity',
    description: '<string>',
    colour: '#0746c8',
    currency: 'EUR'
  })
};

fetch('https://api.infinity.swiss/v1/accounts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.infinity.swiss/v1/accounts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'number' => 6410,
    'name' => 'Electricity',
    'description' => '<string>',
    'colour' => '#0746c8',
    'currency' => 'EUR'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.infinity.swiss/v1/accounts"

	payload := strings.NewReader("{\n  \"number\": 6410,\n  \"name\": \"Electricity\",\n  \"description\": \"<string>\",\n  \"colour\": \"#0746c8\",\n  \"currency\": \"EUR\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.infinity.swiss/v1/accounts")
  .header("x-api-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"number\": 6410,\n  \"name\": \"Electricity\",\n  \"description\": \"<string>\",\n  \"colour\": \"#0746c8\",\n  \"currency\": \"EUR\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.infinity.swiss/v1/accounts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"number\": 6410,\n  \"name\": \"Electricity\",\n  \"description\": \"<string>\",\n  \"colour\": \"#0746c8\",\n  \"currency\": \"EUR\"\n}"

response = http.request(request)
puts response.read_body

{
  "account": {
    "number": 1020,
    "name": "Bank",
    "type": "assets",
    "currency": "CHF",
    "isSystemAccount": true,
    "isTaxApplicable": true,
    "description": "<string>",
    "colour": "#0746c8"
  }
}

{
  "code": "<string>",
  "invalidFields": [
    "colour"
  ]
}

{
  "code": "general/unauthorised"
}

{
  "code": "<string>"
}

{
  "code": "<string>"
}

For developers

Accounting

Chart of accounts

Receipts

Contacts

Invoices

Estimates

Projects

Work entries

Creating an account

Foreign currency accounts

Authorizations

Body

Response

​Creating an account

​Foreign currency accounts

Authorizations

Body

Response

Creating an account

Foreign currency accounts