Business Setup

Step 1: Business Setup #

The business, or Entity as its referred to in the system is the person, partnership, company or whatever other form of organization for which the reports are perpared.

The Entity #

To create an Entity on the Microbooks platform you need its name and Reporting Currency. Specifying the Currency Code will create a Currency object and associate it with the Entity.

Request #

curl --location --request POST '' \
    --header "Authorization: Bearer <bearer_token>" \
    --data-raw '{
        "name": "Acme Inc",
        "currency_code": "USD",
import requests

url = ""
body = {"name": "Acme Inc", "currency_code": "USD"}
headers = {"Authorization": "Bearer <bearer_token>"}

response = requests.request("POST", url, headers=headers, json=body)

var request = require('request');
var options = {
    'method': 'POST',
    'url': '',
    'headers': {'Authorization': 'Bearer <bearer_token>'},
    'body': '{
        "name": "Acme Inc", 
        "currency_code": "USD", 
request(options, function (error, response) {
    if (error) throw new Error(error);
$client = new Client();
$body = '{
    "name": "Acme Inc",
    "currency_code": "USD",
$request = new Request('POST', '', 
    [headers' => ['Authorization' => 'Bearer <bearer_token>']], 
$res = $client->sendAsync($request)->wait();
echo $res->getBody();
var client = new RestClient("");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
var body = "{
    \"name\": \"Acme Inc\", 
    \"currency_code\": \"USD\", 
request.AddParameter("text/plain", body,  ParameterType.RequestBody);
request.AddHeader("Authorization", "Bearer " + <bearer_token>);
IRestResponse response = client.Execute(request);

Response #

    "message":"Entity: Acme Inc created successfully",
    "resource": {
        "name":"Acme Inc",
        "current_reporting_period": {
        "currency": {
            "name":"US Dollar",

For more details on the Entity endpoint check out the How To Guide page as well as the Postman API Reference.