POST
/
organizations
Create Orgs
curl --request POST \
  --url https://dev.intermezzo.ai/organizations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "legal_name": "<string>",
  "bank_accounts": [
    {
      "financial_institution_name": "<string>",
      "account_number": "DE: DE89370400440532013000",
      "routing_number": "DE: 370400440",
      "iban": "DE: DE89370400440532013000",
      "swift_code": "DE: COBADEFFXXX",
      "account_details": {},
      "is_active": true,
      "is_primary": false
    }
  ],
  "preferences": {
    "valid_from": "2023-12-25",
    "valid_to": "2023-12-25",
    "is_insolvent": false,
    "insolvency_start_date": "2023-12-25",
    "insolvency_end_date": "2023-12-25",
    "insolvency_company_number": "<string>",
    "extra_paid_leave_days": 123,
    "first_payroll_date": "2023-12-25",
    "last_payroll_date": "2023-12-25",
    "first_payroll_intermezzo": "2023-12-25",
    "logo_id": "<string>",
    "preferences_country": "DE",
    "insurance_credit_preference": "<string>",
    "days_for_sickness_certificate": 4
  },
  "valid_from": "2023-12-25"
}
'
import requests

url = "https://dev.intermezzo.ai/organizations"

payload = {
    "legal_name": "<string>",
    "bank_accounts": [
        {
            "financial_institution_name": "<string>",
            "account_number": "DE: DE89370400440532013000",
            "routing_number": "DE: 370400440",
            "iban": "DE: DE89370400440532013000",
            "swift_code": "DE: COBADEFFXXX",
            "account_details": {},
            "is_active": True,
            "is_primary": False
        }
    ],
    "preferences": {
        "valid_from": "2023-12-25",
        "valid_to": "2023-12-25",
        "is_insolvent": False,
        "insolvency_start_date": "2023-12-25",
        "insolvency_end_date": "2023-12-25",
        "insolvency_company_number": "<string>",
        "extra_paid_leave_days": 123,
        "first_payroll_date": "2023-12-25",
        "last_payroll_date": "2023-12-25",
        "first_payroll_intermezzo": "2023-12-25",
        "logo_id": "<string>",
        "preferences_country": "DE",
        "insurance_credit_preference": "<string>",
        "days_for_sickness_certificate": 4
    },
    "valid_from": "2023-12-25"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    legal_name: '<string>',
    bank_accounts: [
      {
        financial_institution_name: '<string>',
        account_number: 'DE: DE89370400440532013000',
        routing_number: 'DE: 370400440',
        iban: 'DE: DE89370400440532013000',
        swift_code: 'DE: COBADEFFXXX',
        account_details: {},
        is_active: true,
        is_primary: false
      }
    ],
    preferences: {
      valid_from: '2023-12-25',
      valid_to: '2023-12-25',
      is_insolvent: false,
      insolvency_start_date: '2023-12-25',
      insolvency_end_date: '2023-12-25',
      insolvency_company_number: '<string>',
      extra_paid_leave_days: 123,
      first_payroll_date: '2023-12-25',
      last_payroll_date: '2023-12-25',
      first_payroll_intermezzo: '2023-12-25',
      logo_id: '<string>',
      preferences_country: 'DE',
      insurance_credit_preference: '<string>',
      days_for_sickness_certificate: 4
    },
    valid_from: '2023-12-25'
  })
};

fetch('https://dev.intermezzo.ai/organizations', 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://dev.intermezzo.ai/organizations",
  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([
    'legal_name' => '<string>',
    'bank_accounts' => [
        [
                'financial_institution_name' => '<string>',
                'account_number' => 'DE: DE89370400440532013000',
                'routing_number' => 'DE: 370400440',
                'iban' => 'DE: DE89370400440532013000',
                'swift_code' => 'DE: COBADEFFXXX',
                'account_details' => [
                                
                ],
                'is_active' => true,
                'is_primary' => false
        ]
    ],
    'preferences' => [
        'valid_from' => '2023-12-25',
        'valid_to' => '2023-12-25',
        'is_insolvent' => false,
        'insolvency_start_date' => '2023-12-25',
        'insolvency_end_date' => '2023-12-25',
        'insolvency_company_number' => '<string>',
        'extra_paid_leave_days' => 123,
        'first_payroll_date' => '2023-12-25',
        'last_payroll_date' => '2023-12-25',
        'first_payroll_intermezzo' => '2023-12-25',
        'logo_id' => '<string>',
        'preferences_country' => 'DE',
        'insurance_credit_preference' => '<string>',
        'days_for_sickness_certificate' => 4
    ],
    'valid_from' => '2023-12-25'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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://dev.intermezzo.ai/organizations"

	payload := strings.NewReader("{\n  \"legal_name\": \"<string>\",\n  \"bank_accounts\": [\n    {\n      \"financial_institution_name\": \"<string>\",\n      \"account_number\": \"DE: DE89370400440532013000\",\n      \"routing_number\": \"DE: 370400440\",\n      \"iban\": \"DE: DE89370400440532013000\",\n      \"swift_code\": \"DE: COBADEFFXXX\",\n      \"account_details\": {},\n      \"is_active\": true,\n      \"is_primary\": false\n    }\n  ],\n  \"preferences\": {\n    \"valid_from\": \"2023-12-25\",\n    \"valid_to\": \"2023-12-25\",\n    \"is_insolvent\": false,\n    \"insolvency_start_date\": \"2023-12-25\",\n    \"insolvency_end_date\": \"2023-12-25\",\n    \"insolvency_company_number\": \"<string>\",\n    \"extra_paid_leave_days\": 123,\n    \"first_payroll_date\": \"2023-12-25\",\n    \"last_payroll_date\": \"2023-12-25\",\n    \"first_payroll_intermezzo\": \"2023-12-25\",\n    \"logo_id\": \"<string>\",\n    \"preferences_country\": \"DE\",\n    \"insurance_credit_preference\": \"<string>\",\n    \"days_for_sickness_certificate\": 4\n  },\n  \"valid_from\": \"2023-12-25\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://dev.intermezzo.ai/organizations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"legal_name\": \"<string>\",\n  \"bank_accounts\": [\n    {\n      \"financial_institution_name\": \"<string>\",\n      \"account_number\": \"DE: DE89370400440532013000\",\n      \"routing_number\": \"DE: 370400440\",\n      \"iban\": \"DE: DE89370400440532013000\",\n      \"swift_code\": \"DE: COBADEFFXXX\",\n      \"account_details\": {},\n      \"is_active\": true,\n      \"is_primary\": false\n    }\n  ],\n  \"preferences\": {\n    \"valid_from\": \"2023-12-25\",\n    \"valid_to\": \"2023-12-25\",\n    \"is_insolvent\": false,\n    \"insolvency_start_date\": \"2023-12-25\",\n    \"insolvency_end_date\": \"2023-12-25\",\n    \"insolvency_company_number\": \"<string>\",\n    \"extra_paid_leave_days\": 123,\n    \"first_payroll_date\": \"2023-12-25\",\n    \"last_payroll_date\": \"2023-12-25\",\n    \"first_payroll_intermezzo\": \"2023-12-25\",\n    \"logo_id\": \"<string>\",\n    \"preferences_country\": \"DE\",\n    \"insurance_credit_preference\": \"<string>\",\n    \"days_for_sickness_certificate\": 4\n  },\n  \"valid_from\": \"2023-12-25\"\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://dev.intermezzo.ai/organizations")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"legal_name\": \"<string>\",\n  \"bank_accounts\": [\n    {\n      \"financial_institution_name\": \"<string>\",\n      \"account_number\": \"DE: DE89370400440532013000\",\n      \"routing_number\": \"DE: 370400440\",\n      \"iban\": \"DE: DE89370400440532013000\",\n      \"swift_code\": \"DE: COBADEFFXXX\",\n      \"account_details\": {},\n      \"is_active\": true,\n      \"is_primary\": false\n    }\n  ],\n  \"preferences\": {\n    \"valid_from\": \"2023-12-25\",\n    \"valid_to\": \"2023-12-25\",\n    \"is_insolvent\": false,\n    \"insolvency_start_date\": \"2023-12-25\",\n    \"insolvency_end_date\": \"2023-12-25\",\n    \"insolvency_company_number\": \"<string>\",\n    \"extra_paid_leave_days\": 123,\n    \"first_payroll_date\": \"2023-12-25\",\n    \"last_payroll_date\": \"2023-12-25\",\n    \"first_payroll_intermezzo\": \"2023-12-25\",\n    \"logo_id\": \"<string>\",\n    \"preferences_country\": \"DE\",\n    \"insurance_credit_preference\": \"<string>\",\n    \"days_for_sickness_certificate\": 4\n  },\n  \"valid_from\": \"2023-12-25\"\n}"

response = http.request(request)
puts response.read_body
{
  "legal_name": "<string>",
  "address": {
    "id": "<string>",
    "address": "<string>",
    "components": {
      "formatted_address": "<string>",
      "street_number": "<string>",
      "road": "<string>",
      "city": "<string>",
      "state": "<string>",
      "country": "<string>",
      "postal_code": "<string>",
      "postal_code_suffix": "<string>",
      "latitude": 123,
      "longitude": 123
    },
    "content": {
      "normalized_address": "<string>",
      "country_code": "DE",
      "address_type": "HAUSANSCHRIFT"
    }
  },
  "id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "work_sites": [
    {
      "name": "<string>",
      "address": {
        "id": "<string>",
        "address": "<string>",
        "components": {
          "formatted_address": "<string>",
          "street_number": "<string>",
          "road": "<string>",
          "city": "<string>",
          "state": "<string>",
          "country": "<string>",
          "postal_code": "<string>",
          "postal_code_suffix": "<string>",
          "latitude": 123,
          "longitude": 123
        },
        "content": {
          "normalized_address": "<string>",
          "country_code": "DE",
          "address_type": "HAUSANSCHRIFT"
        }
      },
      "is_active": true,
      "is_primary": true,
      "id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "correspondence_address": {
        "id": "<string>",
        "address": "<string>",
        "components": {
          "formatted_address": "<string>",
          "street_number": "<string>",
          "road": "<string>",
          "city": "<string>",
          "state": "<string>",
          "country": "<string>",
          "postal_code": "<string>",
          "postal_code_suffix": "<string>",
          "latitude": 123,
          "longitude": 123
        },
        "content": {
          "normalized_address": "<string>",
          "country_code": "DE",
          "address_type": "HAUSANSCHRIFT"
        }
      },
      "valid_from": "2023-12-25",
      "valid_to": "2023-12-25",
      "org_id": "<string>",
      "contacts": [
        {
          "name": "<string>",
          "id": "<string>",
          "email": "jsmith@example.com",
          "phone": {
            "phone_number": "<string>"
          },
          "roles": []
        }
      ],
      "tax_identifiers": {
        "id": 123,
        "valid_from": "2023-12-25",
        "valid_to": "2023-12-25",
        "tax_data": {
          "country": "<string>",
          "valid_from": "2023-12-25",
          "valid_to": "2023-12-25",
          "tax_number": "<string>",
          "is_employee_flat_tax": false,
          "is_employee_mini_job_flat_tax": false
        }
      },
      "insurance_data": {
        "id": 123,
        "valid_from": "2023-12-25",
        "valid_to": "2023-12-25",
        "insurance_country": "DE",
        "worksite_location_number": "98797889",
        "accident_insurance_company_number": "98797889",
        "accident_insurance_pin": "DE-WS-PIN-456",
        "payroll_service_provider_number": "98797889",
        "payroll_processing_location_number": "98797889"
      }
    }
  ],
  "bank_accounts": [
    {
      "financial_institution_name": "<string>",
      "id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "account_number": "DE: DE89370400440532013000",
      "routing_number": "DE: 370400440",
      "iban": "DE: DE89370400440532013000",
      "swift_code": "DE: COBADEFFXXX",
      "account_details": {},
      "is_active": true,
      "is_primary": false
    }
  ],
  "preferences": {
    "id": 123,
    "valid_from": "2023-12-25",
    "valid_to": "2023-12-25",
    "is_insolvent": false,
    "insolvency_start_date": "2023-12-25",
    "insolvency_end_date": "2023-12-25",
    "insolvency_company_number": "<string>",
    "extra_paid_leave_days": 123,
    "first_payroll_date": "2023-12-25",
    "last_payroll_date": "2023-12-25",
    "first_payroll_intermezzo": "2023-12-25",
    "logo_id": "<string>",
    "preferences_country": "DE",
    "insurance_credit_preference": "<string>",
    "days_for_sickness_certificate": 4
  },
  "correspondence_address": {
    "id": "<string>",
    "address": "<string>",
    "components": {
      "formatted_address": "<string>",
      "street_number": "<string>",
      "road": "<string>",
      "city": "<string>",
      "state": "<string>",
      "country": "<string>",
      "postal_code": "<string>",
      "postal_code_suffix": "<string>",
      "latitude": 123,
      "longitude": 123
    },
    "content": {
      "normalized_address": "<string>",
      "country_code": "DE",
      "address_type": "HAUSANSCHRIFT"
    }
  },
  "dba_name": "<string>",
  "incorporation_date": "2023-12-25",
  "website": "<string>",
  "external_ref": "<string>",
  "valid_from": "2023-12-25",
  "valid_to": "2023-12-25",
  "shutdown_date": "2023-12-25",
  "contacts": [
    {
      "name": "<string>",
      "id": "<string>",
      "email": "jsmith@example.com",
      "phone": {
        "phone_number": "<string>"
      },
      "roles": []
    }
  ],
  "tax_identifiers": {
    "id": 123,
    "valid_from": "2023-12-25",
    "valid_to": "2023-12-25",
    "tax_data": {
      "country": "<string>",
      "valid_from": "2023-12-25",
      "valid_to": "2023-12-25",
      "tax_number": "<string>",
      "is_employee_flat_tax": false,
      "is_employee_mini_job_flat_tax": false
    }
  },
  "insurance_data": {
    "id": 123,
    "valid_from": "2023-12-25",
    "valid_to": "2023-12-25",
    "insurance_country": "DE",
    "company_number": "98797889",
    "unrs": "DE987654321",
    "accident_insurance_company_number": "98797889",
    "accident_insurance_pin": "12345",
    "payroll_service_provider_number": "98797889",
    "payroll_processing_location_number": "98797889",
    "u1_selected": false,
    "u2_selected": false,
    "u3_selected": false,
    "agency_id": "<string>",
    "alternate_agency_id": "<string>",
    "contact_id": "<string>"
  },
  "sepa_mandates": [
    {
      "creditor_id": "<string>",
      "bank_account_id": "<string>",
      "is_recurring": true,
      "id": "<string>",
      "created_by": "<string>",
      "valid_from": "2023-12-25",
      "valid_to": "2023-12-25",
      "mandate_reference": "<string>"
    }
  ]
}
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Get token from Auth0 and paste it here

Body

application/json
​
legal_name
string
required
​
bank_accounts
BankAccountRequest · object[]
required
​
preferences
DEOrganizationPreferencesRequest · object
required
​
validate_legal_name_against_blacklist
boolean
default:true

Whether or not the legal name should be checked for terms on blacklist

​
registration_country
string
default:DE
Allowed value: "DE"
​
address
AddressRequest · object
​
correspondence_address
AddressRequest · object | null
​
dba_name
string | null
​
incorporation_date
string<date> | null
​
website
string | null
​
external_ref
string | null
Maximum string length: 255
​
valid_from
string<date> | null
​
valid_to
string<date> | null
​
work_sites
WorksiteRequest · object[]
​
contacts
ContactRequest · object[] | null
​
sepa_mandates
SepaMandateRequest · object[] | null
​
insurance_data
DEOrganizationInsuranceDetailsRequest · object
​
tax_identifiers
TaxIdentifiersRequest · object | null

Response

Successful Response

​
registration_country
enum<string>
required

Enum for CountryAlpha2 codes

Available options:
DE,
IE,
GB,
US,
GB
​
legal_name
string
required
​
address
AddressResponse · object
required
​
id
string
required
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
work_sites
WorksiteResponse · object[] | null
required
​
bank_accounts
BankAccountResponse · object[] | null
required
​
preferences
DEOrganizationPreferencesResponse · object
required
​
correspondence_address
AddressResponse · object | null
​
dba_name
string | null
​
incorporation_date
string<date> | null
​
website
string | null
​
external_ref
string | null
Maximum string length: 255
​
valid_from
string<date> | null
​
valid_to
string<date> | null
​
shutdown_date
string<date> | null
​
contacts
ContactResponse · object[] | null
​
tax_identifiers
TaxIdentifiersResponse · object | null
​
insurance_data
DEOrganizationInsuranceDetailsResponse · object
​
sepa_mandates
SepaMandateResponse · object[]