cURL
curl --request POST \
--url https://api.maesn.dev/accounting/contacts/async \
--header 'Content-Type: application/json' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--data '
{
"contactType": "CONTACT_PERSON",
"addresses": [
{
"addressLine1": "Lucky street 1",
"addressLine2": "2nd floor",
"city": "Berlin",
"countryCode": "DE",
"postalCode": "10243",
"type": "BILLING"
}
],
"bankAccounts": [
{
"id": "5a6b7f5dw45c1c-403e-ad56-202fbc312414",
"bankName": "Sparkasse",
"bic": "DEUTDEFF",
"code": "50010517",
"iban": "DE89370400440532013000",
"number": 5407324931
}
],
"businessRegistrationNumber": "12345678",
"companyName": "maesn",
"contactPersons": [
{
"birthDate": "1990-05-12T00:00:00.000Z",
"emailAddresses": [
{
"email": "john.doe@company.com",
"type": "BUSINESS"
}
],
"firstName": "John",
"jobTitle": "Managing Director",
"lastName": "Doe",
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
],
"salutation": "Mr"
}
],
"emailAddresses": [
{
"email": "john.doe@company.com",
"type": "BUSINESS"
}
],
"isCustomer": true,
"isSupplier": false,
"number": "1042",
"parentId": "3b1e4c72-9d8a-42f5-9c6b-1a7f0e5d8c34",
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
],
"projectId": "3",
"vatId": "DE123456789",
"website": "https://www.maesn.com"
}
'import requests
url = "https://api.maesn.dev/accounting/contacts/async"
payload = {
"contactType": "CONTACT_PERSON",
"addresses": [
{
"addressLine1": "Lucky street 1",
"addressLine2": "2nd floor",
"city": "Berlin",
"countryCode": "DE",
"postalCode": "10243",
"type": "BILLING"
}
],
"bankAccounts": [
{
"id": "5a6b7f5dw45c1c-403e-ad56-202fbc312414",
"bankName": "Sparkasse",
"bic": "DEUTDEFF",
"code": "50010517",
"iban": "DE89370400440532013000",
"number": 5407324931
}
],
"businessRegistrationNumber": "12345678",
"companyName": "maesn",
"contactPersons": [
{
"birthDate": "1990-05-12T00:00:00.000Z",
"emailAddresses": [
{
"email": "john.doe@company.com",
"type": "BUSINESS"
}
],
"firstName": "John",
"jobTitle": "Managing Director",
"lastName": "Doe",
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
],
"salutation": "Mr"
}
],
"emailAddresses": [
{
"email": "john.doe@company.com",
"type": "BUSINESS"
}
],
"isCustomer": True,
"isSupplier": False,
"number": "1042",
"parentId": "3b1e4c72-9d8a-42f5-9c6b-1a7f0e5d8c34",
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
],
"projectId": "3",
"vatId": "DE123456789",
"website": "https://www.maesn.com"
}
headers = {
"X-API-KEY": "<x-api-key>",
"X-ACCOUNT-KEY": "<x-account-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-API-KEY': '<x-api-key>',
'X-ACCOUNT-KEY': '<x-account-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
contactType: 'CONTACT_PERSON',
addresses: [
{
addressLine1: 'Lucky street 1',
addressLine2: '2nd floor',
city: 'Berlin',
countryCode: 'DE',
postalCode: '10243',
type: 'BILLING'
}
],
bankAccounts: [
{
id: '5a6b7f5dw45c1c-403e-ad56-202fbc312414',
bankName: 'Sparkasse',
bic: 'DEUTDEFF',
code: '50010517',
iban: 'DE89370400440532013000',
number: 5407324931
}
],
businessRegistrationNumber: '12345678',
companyName: 'maesn',
contactPersons: [
{
birthDate: '1990-05-12T00:00:00.000Z',
emailAddresses: [{email: 'john.doe@company.com', type: 'BUSINESS'}],
firstName: 'John',
jobTitle: 'Managing Director',
lastName: 'Doe',
phoneNumbers: [{number: '+49 7163307056', type: 'MOBILE'}],
salutation: 'Mr'
}
],
emailAddresses: [{email: 'john.doe@company.com', type: 'BUSINESS'}],
isCustomer: true,
isSupplier: false,
number: '1042',
parentId: '3b1e4c72-9d8a-42f5-9c6b-1a7f0e5d8c34',
phoneNumbers: [{number: '+49 7163307056', type: 'MOBILE'}],
projectId: '3',
vatId: 'DE123456789',
website: 'https://www.maesn.com'
})
};
fetch('https://api.maesn.dev/accounting/contacts/async', 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.maesn.dev/accounting/contacts/async",
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([
'contactType' => 'CONTACT_PERSON',
'addresses' => [
[
'addressLine1' => 'Lucky street 1',
'addressLine2' => '2nd floor',
'city' => 'Berlin',
'countryCode' => 'DE',
'postalCode' => '10243',
'type' => 'BILLING'
]
],
'bankAccounts' => [
[
'id' => '5a6b7f5dw45c1c-403e-ad56-202fbc312414',
'bankName' => 'Sparkasse',
'bic' => 'DEUTDEFF',
'code' => '50010517',
'iban' => 'DE89370400440532013000',
'number' => 5407324931
]
],
'businessRegistrationNumber' => '12345678',
'companyName' => 'maesn',
'contactPersons' => [
[
'birthDate' => '1990-05-12T00:00:00.000Z',
'emailAddresses' => [
[
'email' => 'john.doe@company.com',
'type' => 'BUSINESS'
]
],
'firstName' => 'John',
'jobTitle' => 'Managing Director',
'lastName' => 'Doe',
'phoneNumbers' => [
[
'number' => '+49 7163307056',
'type' => 'MOBILE'
]
],
'salutation' => 'Mr'
]
],
'emailAddresses' => [
[
'email' => 'john.doe@company.com',
'type' => 'BUSINESS'
]
],
'isCustomer' => true,
'isSupplier' => false,
'number' => '1042',
'parentId' => '3b1e4c72-9d8a-42f5-9c6b-1a7f0e5d8c34',
'phoneNumbers' => [
[
'number' => '+49 7163307056',
'type' => 'MOBILE'
]
],
'projectId' => '3',
'vatId' => 'DE123456789',
'website' => 'https://www.maesn.com'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-ACCOUNT-KEY: <x-account-key>",
"X-API-KEY: <x-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.maesn.dev/accounting/contacts/async"
payload := strings.NewReader("{\n \"contactType\": \"CONTACT_PERSON\",\n \"addresses\": [\n {\n \"addressLine1\": \"Lucky street 1\",\n \"addressLine2\": \"2nd floor\",\n \"city\": \"Berlin\",\n \"countryCode\": \"DE\",\n \"postalCode\": \"10243\",\n \"type\": \"BILLING\"\n }\n ],\n \"bankAccounts\": [\n {\n \"id\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\n \"bankName\": \"Sparkasse\",\n \"bic\": \"DEUTDEFF\",\n \"code\": \"50010517\",\n \"iban\": \"DE89370400440532013000\",\n \"number\": 5407324931\n }\n ],\n \"businessRegistrationNumber\": \"12345678\",\n \"companyName\": \"maesn\",\n \"contactPersons\": [\n {\n \"birthDate\": \"1990-05-12T00:00:00.000Z\",\n \"emailAddresses\": [\n {\n \"email\": \"john.doe@company.com\",\n \"type\": \"BUSINESS\"\n }\n ],\n \"firstName\": \"John\",\n \"jobTitle\": \"Managing Director\",\n \"lastName\": \"Doe\",\n \"phoneNumbers\": [\n {\n \"number\": \"+49 7163307056\",\n \"type\": \"MOBILE\"\n }\n ],\n \"salutation\": \"Mr\"\n }\n ],\n \"emailAddresses\": [\n {\n \"email\": \"john.doe@company.com\",\n \"type\": \"BUSINESS\"\n }\n ],\n \"isCustomer\": true,\n \"isSupplier\": false,\n \"number\": \"1042\",\n \"parentId\": \"3b1e4c72-9d8a-42f5-9c6b-1a7f0e5d8c34\",\n \"phoneNumbers\": [\n {\n \"number\": \"+49 7163307056\",\n \"type\": \"MOBILE\"\n }\n ],\n \"projectId\": \"3\",\n \"vatId\": \"DE123456789\",\n \"website\": \"https://www.maesn.com\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<x-api-key>")
req.Header.Add("X-ACCOUNT-KEY", "<x-account-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.maesn.dev/accounting/contacts/async")
.header("X-API-KEY", "<x-api-key>")
.header("X-ACCOUNT-KEY", "<x-account-key>")
.header("Content-Type", "application/json")
.body("{\n \"contactType\": \"CONTACT_PERSON\",\n \"addresses\": [\n {\n \"addressLine1\": \"Lucky street 1\",\n \"addressLine2\": \"2nd floor\",\n \"city\": \"Berlin\",\n \"countryCode\": \"DE\",\n \"postalCode\": \"10243\",\n \"type\": \"BILLING\"\n }\n ],\n \"bankAccounts\": [\n {\n \"id\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\n \"bankName\": \"Sparkasse\",\n \"bic\": \"DEUTDEFF\",\n \"code\": \"50010517\",\n \"iban\": \"DE89370400440532013000\",\n \"number\": 5407324931\n }\n ],\n \"businessRegistrationNumber\": \"12345678\",\n \"companyName\": \"maesn\",\n \"contactPersons\": [\n {\n \"birthDate\": \"1990-05-12T00:00:00.000Z\",\n \"emailAddresses\": [\n {\n \"email\": \"john.doe@company.com\",\n \"type\": \"BUSINESS\"\n }\n ],\n \"firstName\": \"John\",\n \"jobTitle\": \"Managing Director\",\n \"lastName\": \"Doe\",\n \"phoneNumbers\": [\n {\n \"number\": \"+49 7163307056\",\n \"type\": \"MOBILE\"\n }\n ],\n \"salutation\": \"Mr\"\n }\n ],\n \"emailAddresses\": [\n {\n \"email\": \"john.doe@company.com\",\n \"type\": \"BUSINESS\"\n }\n ],\n \"isCustomer\": true,\n \"isSupplier\": false,\n \"number\": \"1042\",\n \"parentId\": \"3b1e4c72-9d8a-42f5-9c6b-1a7f0e5d8c34\",\n \"phoneNumbers\": [\n {\n \"number\": \"+49 7163307056\",\n \"type\": \"MOBILE\"\n }\n ],\n \"projectId\": \"3\",\n \"vatId\": \"DE123456789\",\n \"website\": \"https://www.maesn.com\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.maesn.dev/accounting/contacts/async")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<x-api-key>'
request["X-ACCOUNT-KEY"] = '<x-account-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"contactType\": \"CONTACT_PERSON\",\n \"addresses\": [\n {\n \"addressLine1\": \"Lucky street 1\",\n \"addressLine2\": \"2nd floor\",\n \"city\": \"Berlin\",\n \"countryCode\": \"DE\",\n \"postalCode\": \"10243\",\n \"type\": \"BILLING\"\n }\n ],\n \"bankAccounts\": [\n {\n \"id\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\n \"bankName\": \"Sparkasse\",\n \"bic\": \"DEUTDEFF\",\n \"code\": \"50010517\",\n \"iban\": \"DE89370400440532013000\",\n \"number\": 5407324931\n }\n ],\n \"businessRegistrationNumber\": \"12345678\",\n \"companyName\": \"maesn\",\n \"contactPersons\": [\n {\n \"birthDate\": \"1990-05-12T00:00:00.000Z\",\n \"emailAddresses\": [\n {\n \"email\": \"john.doe@company.com\",\n \"type\": \"BUSINESS\"\n }\n ],\n \"firstName\": \"John\",\n \"jobTitle\": \"Managing Director\",\n \"lastName\": \"Doe\",\n \"phoneNumbers\": [\n {\n \"number\": \"+49 7163307056\",\n \"type\": \"MOBILE\"\n }\n ],\n \"salutation\": \"Mr\"\n }\n ],\n \"emailAddresses\": [\n {\n \"email\": \"john.doe@company.com\",\n \"type\": \"BUSINESS\"\n }\n ],\n \"isCustomer\": true,\n \"isSupplier\": false,\n \"number\": \"1042\",\n \"parentId\": \"3b1e4c72-9d8a-42f5-9c6b-1a7f0e5d8c34\",\n \"phoneNumbers\": [\n {\n \"number\": \"+49 7163307056\",\n \"type\": \"MOBILE\"\n }\n ],\n \"projectId\": \"3\",\n \"vatId\": \"DE123456789\",\n \"website\": \"https://www.maesn.com\"\n}"
response = http.request(request)
puts response.read_body{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 125,
"perPage": 50,
"currentPage": 1,
"totalPages": 3
},
"partialErrors": [
{
"code": "FILE_UPLOAD_FAILED",
"message": "Attachment invoice.pdf could not be uploaded to the target system."
}
]
},
"data": {
"taskId": "02cc5849-b23c-48fe-8a9b-96f74bfc9571"
}
}Contacts
Create contact async
POST
/
accounting
/
contacts
/
async
cURL
curl --request POST \
--url https://api.maesn.dev/accounting/contacts/async \
--header 'Content-Type: application/json' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--data '
{
"contactType": "CONTACT_PERSON",
"addresses": [
{
"addressLine1": "Lucky street 1",
"addressLine2": "2nd floor",
"city": "Berlin",
"countryCode": "DE",
"postalCode": "10243",
"type": "BILLING"
}
],
"bankAccounts": [
{
"id": "5a6b7f5dw45c1c-403e-ad56-202fbc312414",
"bankName": "Sparkasse",
"bic": "DEUTDEFF",
"code": "50010517",
"iban": "DE89370400440532013000",
"number": 5407324931
}
],
"businessRegistrationNumber": "12345678",
"companyName": "maesn",
"contactPersons": [
{
"birthDate": "1990-05-12T00:00:00.000Z",
"emailAddresses": [
{
"email": "john.doe@company.com",
"type": "BUSINESS"
}
],
"firstName": "John",
"jobTitle": "Managing Director",
"lastName": "Doe",
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
],
"salutation": "Mr"
}
],
"emailAddresses": [
{
"email": "john.doe@company.com",
"type": "BUSINESS"
}
],
"isCustomer": true,
"isSupplier": false,
"number": "1042",
"parentId": "3b1e4c72-9d8a-42f5-9c6b-1a7f0e5d8c34",
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
],
"projectId": "3",
"vatId": "DE123456789",
"website": "https://www.maesn.com"
}
'import requests
url = "https://api.maesn.dev/accounting/contacts/async"
payload = {
"contactType": "CONTACT_PERSON",
"addresses": [
{
"addressLine1": "Lucky street 1",
"addressLine2": "2nd floor",
"city": "Berlin",
"countryCode": "DE",
"postalCode": "10243",
"type": "BILLING"
}
],
"bankAccounts": [
{
"id": "5a6b7f5dw45c1c-403e-ad56-202fbc312414",
"bankName": "Sparkasse",
"bic": "DEUTDEFF",
"code": "50010517",
"iban": "DE89370400440532013000",
"number": 5407324931
}
],
"businessRegistrationNumber": "12345678",
"companyName": "maesn",
"contactPersons": [
{
"birthDate": "1990-05-12T00:00:00.000Z",
"emailAddresses": [
{
"email": "john.doe@company.com",
"type": "BUSINESS"
}
],
"firstName": "John",
"jobTitle": "Managing Director",
"lastName": "Doe",
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
],
"salutation": "Mr"
}
],
"emailAddresses": [
{
"email": "john.doe@company.com",
"type": "BUSINESS"
}
],
"isCustomer": True,
"isSupplier": False,
"number": "1042",
"parentId": "3b1e4c72-9d8a-42f5-9c6b-1a7f0e5d8c34",
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
],
"projectId": "3",
"vatId": "DE123456789",
"website": "https://www.maesn.com"
}
headers = {
"X-API-KEY": "<x-api-key>",
"X-ACCOUNT-KEY": "<x-account-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-API-KEY': '<x-api-key>',
'X-ACCOUNT-KEY': '<x-account-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
contactType: 'CONTACT_PERSON',
addresses: [
{
addressLine1: 'Lucky street 1',
addressLine2: '2nd floor',
city: 'Berlin',
countryCode: 'DE',
postalCode: '10243',
type: 'BILLING'
}
],
bankAccounts: [
{
id: '5a6b7f5dw45c1c-403e-ad56-202fbc312414',
bankName: 'Sparkasse',
bic: 'DEUTDEFF',
code: '50010517',
iban: 'DE89370400440532013000',
number: 5407324931
}
],
businessRegistrationNumber: '12345678',
companyName: 'maesn',
contactPersons: [
{
birthDate: '1990-05-12T00:00:00.000Z',
emailAddresses: [{email: 'john.doe@company.com', type: 'BUSINESS'}],
firstName: 'John',
jobTitle: 'Managing Director',
lastName: 'Doe',
phoneNumbers: [{number: '+49 7163307056', type: 'MOBILE'}],
salutation: 'Mr'
}
],
emailAddresses: [{email: 'john.doe@company.com', type: 'BUSINESS'}],
isCustomer: true,
isSupplier: false,
number: '1042',
parentId: '3b1e4c72-9d8a-42f5-9c6b-1a7f0e5d8c34',
phoneNumbers: [{number: '+49 7163307056', type: 'MOBILE'}],
projectId: '3',
vatId: 'DE123456789',
website: 'https://www.maesn.com'
})
};
fetch('https://api.maesn.dev/accounting/contacts/async', 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.maesn.dev/accounting/contacts/async",
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([
'contactType' => 'CONTACT_PERSON',
'addresses' => [
[
'addressLine1' => 'Lucky street 1',
'addressLine2' => '2nd floor',
'city' => 'Berlin',
'countryCode' => 'DE',
'postalCode' => '10243',
'type' => 'BILLING'
]
],
'bankAccounts' => [
[
'id' => '5a6b7f5dw45c1c-403e-ad56-202fbc312414',
'bankName' => 'Sparkasse',
'bic' => 'DEUTDEFF',
'code' => '50010517',
'iban' => 'DE89370400440532013000',
'number' => 5407324931
]
],
'businessRegistrationNumber' => '12345678',
'companyName' => 'maesn',
'contactPersons' => [
[
'birthDate' => '1990-05-12T00:00:00.000Z',
'emailAddresses' => [
[
'email' => 'john.doe@company.com',
'type' => 'BUSINESS'
]
],
'firstName' => 'John',
'jobTitle' => 'Managing Director',
'lastName' => 'Doe',
'phoneNumbers' => [
[
'number' => '+49 7163307056',
'type' => 'MOBILE'
]
],
'salutation' => 'Mr'
]
],
'emailAddresses' => [
[
'email' => 'john.doe@company.com',
'type' => 'BUSINESS'
]
],
'isCustomer' => true,
'isSupplier' => false,
'number' => '1042',
'parentId' => '3b1e4c72-9d8a-42f5-9c6b-1a7f0e5d8c34',
'phoneNumbers' => [
[
'number' => '+49 7163307056',
'type' => 'MOBILE'
]
],
'projectId' => '3',
'vatId' => 'DE123456789',
'website' => 'https://www.maesn.com'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-ACCOUNT-KEY: <x-account-key>",
"X-API-KEY: <x-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.maesn.dev/accounting/contacts/async"
payload := strings.NewReader("{\n \"contactType\": \"CONTACT_PERSON\",\n \"addresses\": [\n {\n \"addressLine1\": \"Lucky street 1\",\n \"addressLine2\": \"2nd floor\",\n \"city\": \"Berlin\",\n \"countryCode\": \"DE\",\n \"postalCode\": \"10243\",\n \"type\": \"BILLING\"\n }\n ],\n \"bankAccounts\": [\n {\n \"id\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\n \"bankName\": \"Sparkasse\",\n \"bic\": \"DEUTDEFF\",\n \"code\": \"50010517\",\n \"iban\": \"DE89370400440532013000\",\n \"number\": 5407324931\n }\n ],\n \"businessRegistrationNumber\": \"12345678\",\n \"companyName\": \"maesn\",\n \"contactPersons\": [\n {\n \"birthDate\": \"1990-05-12T00:00:00.000Z\",\n \"emailAddresses\": [\n {\n \"email\": \"john.doe@company.com\",\n \"type\": \"BUSINESS\"\n }\n ],\n \"firstName\": \"John\",\n \"jobTitle\": \"Managing Director\",\n \"lastName\": \"Doe\",\n \"phoneNumbers\": [\n {\n \"number\": \"+49 7163307056\",\n \"type\": \"MOBILE\"\n }\n ],\n \"salutation\": \"Mr\"\n }\n ],\n \"emailAddresses\": [\n {\n \"email\": \"john.doe@company.com\",\n \"type\": \"BUSINESS\"\n }\n ],\n \"isCustomer\": true,\n \"isSupplier\": false,\n \"number\": \"1042\",\n \"parentId\": \"3b1e4c72-9d8a-42f5-9c6b-1a7f0e5d8c34\",\n \"phoneNumbers\": [\n {\n \"number\": \"+49 7163307056\",\n \"type\": \"MOBILE\"\n }\n ],\n \"projectId\": \"3\",\n \"vatId\": \"DE123456789\",\n \"website\": \"https://www.maesn.com\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<x-api-key>")
req.Header.Add("X-ACCOUNT-KEY", "<x-account-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.maesn.dev/accounting/contacts/async")
.header("X-API-KEY", "<x-api-key>")
.header("X-ACCOUNT-KEY", "<x-account-key>")
.header("Content-Type", "application/json")
.body("{\n \"contactType\": \"CONTACT_PERSON\",\n \"addresses\": [\n {\n \"addressLine1\": \"Lucky street 1\",\n \"addressLine2\": \"2nd floor\",\n \"city\": \"Berlin\",\n \"countryCode\": \"DE\",\n \"postalCode\": \"10243\",\n \"type\": \"BILLING\"\n }\n ],\n \"bankAccounts\": [\n {\n \"id\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\n \"bankName\": \"Sparkasse\",\n \"bic\": \"DEUTDEFF\",\n \"code\": \"50010517\",\n \"iban\": \"DE89370400440532013000\",\n \"number\": 5407324931\n }\n ],\n \"businessRegistrationNumber\": \"12345678\",\n \"companyName\": \"maesn\",\n \"contactPersons\": [\n {\n \"birthDate\": \"1990-05-12T00:00:00.000Z\",\n \"emailAddresses\": [\n {\n \"email\": \"john.doe@company.com\",\n \"type\": \"BUSINESS\"\n }\n ],\n \"firstName\": \"John\",\n \"jobTitle\": \"Managing Director\",\n \"lastName\": \"Doe\",\n \"phoneNumbers\": [\n {\n \"number\": \"+49 7163307056\",\n \"type\": \"MOBILE\"\n }\n ],\n \"salutation\": \"Mr\"\n }\n ],\n \"emailAddresses\": [\n {\n \"email\": \"john.doe@company.com\",\n \"type\": \"BUSINESS\"\n }\n ],\n \"isCustomer\": true,\n \"isSupplier\": false,\n \"number\": \"1042\",\n \"parentId\": \"3b1e4c72-9d8a-42f5-9c6b-1a7f0e5d8c34\",\n \"phoneNumbers\": [\n {\n \"number\": \"+49 7163307056\",\n \"type\": \"MOBILE\"\n }\n ],\n \"projectId\": \"3\",\n \"vatId\": \"DE123456789\",\n \"website\": \"https://www.maesn.com\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.maesn.dev/accounting/contacts/async")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<x-api-key>'
request["X-ACCOUNT-KEY"] = '<x-account-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"contactType\": \"CONTACT_PERSON\",\n \"addresses\": [\n {\n \"addressLine1\": \"Lucky street 1\",\n \"addressLine2\": \"2nd floor\",\n \"city\": \"Berlin\",\n \"countryCode\": \"DE\",\n \"postalCode\": \"10243\",\n \"type\": \"BILLING\"\n }\n ],\n \"bankAccounts\": [\n {\n \"id\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\n \"bankName\": \"Sparkasse\",\n \"bic\": \"DEUTDEFF\",\n \"code\": \"50010517\",\n \"iban\": \"DE89370400440532013000\",\n \"number\": 5407324931\n }\n ],\n \"businessRegistrationNumber\": \"12345678\",\n \"companyName\": \"maesn\",\n \"contactPersons\": [\n {\n \"birthDate\": \"1990-05-12T00:00:00.000Z\",\n \"emailAddresses\": [\n {\n \"email\": \"john.doe@company.com\",\n \"type\": \"BUSINESS\"\n }\n ],\n \"firstName\": \"John\",\n \"jobTitle\": \"Managing Director\",\n \"lastName\": \"Doe\",\n \"phoneNumbers\": [\n {\n \"number\": \"+49 7163307056\",\n \"type\": \"MOBILE\"\n }\n ],\n \"salutation\": \"Mr\"\n }\n ],\n \"emailAddresses\": [\n {\n \"email\": \"john.doe@company.com\",\n \"type\": \"BUSINESS\"\n }\n ],\n \"isCustomer\": true,\n \"isSupplier\": false,\n \"number\": \"1042\",\n \"parentId\": \"3b1e4c72-9d8a-42f5-9c6b-1a7f0e5d8c34\",\n \"phoneNumbers\": [\n {\n \"number\": \"+49 7163307056\",\n \"type\": \"MOBILE\"\n }\n ],\n \"projectId\": \"3\",\n \"vatId\": \"DE123456789\",\n \"website\": \"https://www.maesn.com\"\n}"
response = http.request(request)
puts response.read_body{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 125,
"perPage": 50,
"currentPage": 1,
"totalPages": 3
},
"partialErrors": [
{
"code": "FILE_UPLOAD_FAILED",
"message": "Attachment invoice.pdf could not be uploaded to the target system."
}
]
},
"data": {
"taskId": "02cc5849-b23c-48fe-8a9b-96f74bfc9571"
}
}Field support per integration
AbaConnect
AbaConnect
This endpoint is asynchronous. The response returns a
taskId. Use /asyncTask/{taskId} to check the task status and obtain the final result once it is ready.Address[]
string
Required for contact type
COMPANY. At most 100 characters.ContactPerson[]
Required for contact type
CONTACT_PERSON. Only one contact person is allowed.Show properties
Show properties
string
required
At most 50 characters.
string
required
At most 100 characters.
EmailAddress[]
enum
required
Available options:
CONTACT_PERSON, COMPANYEmailAddress[]
string
A whole number with at most 10 digits. If you leave it out, Abacus picks the number.
Body
application/json
Available options:
CONTACT_PERSON, COMPANY Example:
"CONTACT_PERSON"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Example:
"12345678"
Example:
"maesn"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Example:
true
Example:
false
Example:
"1042"
Example:
"3b1e4c72-9d8a-42f5-9c6b-1a7f0e5d8c34"
Show child attributes
Show child attributes
Example:
"3"
Example:
"DE123456789"
Example:
"https://www.maesn.com"
Last modified on November 2, 2026
Was this page helpful?