POST
/
accounting
/
contacts
/
bulk
cURL
curl --request POST \
  --url https://api.maesn.dev/accounting/contacts/bulk \
  --header 'Content-Type: application/json' \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '{
  "accountNumberLength": "4",
  "chartOfAccount": "SKR03",
  "entries": [
    {
      "addresses": [
        {
          "addressLine1": "Lucky street 1",
          "addressLine2": "2nd floor",
          "city": "Berlin",
          "countryCode": "DE",
          "postalCode": "10243",
          "type": "BILLING"
        }
      ],
      "accountNumber": "70000",
      "bankAccounts": [
        {
          "bic": "COBADEFFXXX",
          "holder": "John Doe",
          "iban": "DE89370400440532013000",
          "isMainAccount": "true",
          "name": "Sparkasse",
          "sepa": true
        }
      ],
      "companyName": "maesn",
      "contactPersons": [
        {
          "emailAddresses": [
            {
              "email": "john.doe@company.com",
              "type": "BUSINESS"
            }
          ],
          "firstName": "John",
          "lastName": "Doe",
          "phoneNumbers": [
            {
              "number": "+49 7163307056",
              "type": "MOBILE"
            }
          ],
          "salutation": "Mr"
        }
      ],
      "contactType": "CONTACT_PERSON",
      "emailAddresses": [
        {
          "email": "john.doe@company.com",
          "type": "BUSINESS"
        }
      ],
      "number": "1042",
      "phoneNumbers": [
        {
          "number": "+49 7163307056",
          "type": "MOBILE"
        }
      ],
      "projectId": "3",
      "vatId": "DE33445672452"
    }
  ],
  "fiscalYearStartDate": "2025-01-01"
}'
{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 123,
      "perPage": 123,
      "currentPage": 123,
      "totalPages": 123
    }
  },
  "data": {
    "id": "433445",
    "accountNumberLength": "4",
    "chartOfAccount": "SKR03",
    "createdDate": "2021-01-01T00:00:00Z",
    "entries": [
      {
        "addresses": [
          {
            "addressLine1": "Lucky street 1",
            "addressLine2": "2nd floor",
            "city": "Berlin",
            "countryCode": "DE",
            "postalCode": "10243",
            "type": "BILLING"
          }
        ],
        "accountNumber": "70000",
        "bankAccounts": [
          {
            "bic": "COBADEFFXXX",
            "holder": "John Doe",
            "iban": "DE89370400440532013000",
            "isMainAccount": "true",
            "name": "Sparkasse",
            "sepa": true
          }
        ],
        "companyName": "maesn",
        "contactPersons": [
          {
            "emailAddresses": [
              {
                "email": "john.doe@company.com",
                "type": "BUSINESS"
              }
            ],
            "firstName": "John",
            "lastName": "Doe",
            "phoneNumbers": [
              {
                "number": "+49 7163307056",
                "type": "MOBILE"
              }
            ],
            "salutation": "Mr"
          }
        ],
        "contactType": "CONTACT_PERSON",
        "emailAddresses": [
          {
            "email": "john.doe@company.com",
            "type": "BUSINESS"
          }
        ],
        "number": "1042",
        "phoneNumbers": [
          {
            "number": "+49 7163307056",
            "type": "MOBILE"
          }
        ],
        "projectId": "3",
        "vatId": "DE33445672452"
      }
    ],
    "fiscalYearStartDate": "2025-01-01",
    "taskId": "ABBDU8834993NND"
  }
}

​
Field support per integration

Headers

​
X-API-KEY
string
required

API key

Example:

"example value"

​
X-ACCOUNT-KEY
string
required

Account key

Example:

"example value"

Query Parameters

​
companyId
string

Body

application/json

Response

200 - application/json

The response is of type object.