Create contact

cURL

curl --request POST \
  --url https://api.maesn.dev/accounting/contacts \
  --header 'Content-Type: application/json' \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "contactType": "CONTACT_PERSON",
  "id": "92c4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
  "addresses": [
    {
      "addressLine1": "Lucky street 1",
      "addressLine2": "2nd floor",
      "city": "Berlin",
      "countryCode": "DE",
      "postalCode": "10243",
      "type": "BILLING"
    }
  ],
  "companyName": "maesn",
  "contactPersons": [
    {
      "id": "967188f6-8248-4765-b1e8-0f13a3ddb616",
      "emailAddresses": [
        {
          "email": "john.doe@company.com",
          "type": "BUSINESS"
        }
      ],
      "firstName": "John",
      "lastName": "Doe",
      "phoneNumbers": [
        {
          "number": "+49 7163307056",
          "type": "MOBILE"
        }
      ],
      "salutation": "Mr"
    }
  ],
  "emailAddresses": [
    {
      "email": "john.doe@company.com",
      "type": "BUSINESS"
    }
  ],
  "isCustomer": true,
  "isSupplier": false,
  "number": "1042",
  "phoneNumbers": [
    {
      "number": "+49 7163307056",
      "type": "MOBILE"
    }
  ],
  "projectId": "3",
  "website": "https://www.maesn.com"
}
'

{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 125,
      "perPage": 50,
      "currentPage": 1,
      "totalPages": 3
    }
  },
  "data": {
    "id": "92c4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
    "addresses": [
      {
        "addressLine1": "Lucky street 1",
        "addressLine2": "2nd floor",
        "city": "Berlin",
        "countryCode": "DE",
        "postalCode": "10243",
        "type": "BILLING"
      }
    ],
    "companyName": "maesn",
    "contactPersons": [
      {
        "id": "967188f6-8248-4765-b1e8-0f13a3ddb616",
        "emailAddresses": [
          {
            "email": "john.doe@company.com",
            "type": "BUSINESS"
          }
        ],
        "firstName": "John",
        "lastName": "Doe",
        "phoneNumbers": [
          {
            "number": "+49 7163307056",
            "type": "MOBILE"
          }
        ],
        "salutation": "Mr"
      }
    ],
    "contactType": "CONTACT_PERSON",
    "createdDate": "2025-06-01T11:09:11.533Z",
    "emailAddresses": [
      {
        "email": "john.doe@company.com",
        "type": "BUSINESS"
      }
    ],
    "isCustomer": true,
    "isSupplier": false,
    "number": "1042",
    "phoneNumbers": [
      {
        "number": "+49 7163307056",
        "type": "MOBILE"
      }
    ],
    "projectId": "3",
    "updatedDate": "2025-06-01T11:09:11.533Z",
    "website": "https://www.maesn.com"
  }
}

POST

accounting

contacts

cURL

curl --request POST \
  --url https://api.maesn.dev/accounting/contacts \
  --header 'Content-Type: application/json' \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "contactType": "CONTACT_PERSON",
  "id": "92c4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
  "addresses": [
    {
      "addressLine1": "Lucky street 1",
      "addressLine2": "2nd floor",
      "city": "Berlin",
      "countryCode": "DE",
      "postalCode": "10243",
      "type": "BILLING"
    }
  ],
  "companyName": "maesn",
  "contactPersons": [
    {
      "id": "967188f6-8248-4765-b1e8-0f13a3ddb616",
      "emailAddresses": [
        {
          "email": "john.doe@company.com",
          "type": "BUSINESS"
        }
      ],
      "firstName": "John",
      "lastName": "Doe",
      "phoneNumbers": [
        {
          "number": "+49 7163307056",
          "type": "MOBILE"
        }
      ],
      "salutation": "Mr"
    }
  ],
  "emailAddresses": [
    {
      "email": "john.doe@company.com",
      "type": "BUSINESS"
    }
  ],
  "isCustomer": true,
  "isSupplier": false,
  "number": "1042",
  "phoneNumbers": [
    {
      "number": "+49 7163307056",
      "type": "MOBILE"
    }
  ],
  "projectId": "3",
  "website": "https://www.maesn.com"
}
'

{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 125,
      "perPage": 50,
      "currentPage": 1,
      "totalPages": 3
    }
  },
  "data": {
    "id": "92c4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
    "addresses": [
      {
        "addressLine1": "Lucky street 1",
        "addressLine2": "2nd floor",
        "city": "Berlin",
        "countryCode": "DE",
        "postalCode": "10243",
        "type": "BILLING"
      }
    ],
    "companyName": "maesn",
    "contactPersons": [
      {
        "id": "967188f6-8248-4765-b1e8-0f13a3ddb616",
        "emailAddresses": [
          {
            "email": "john.doe@company.com",
            "type": "BUSINESS"
          }
        ],
        "firstName": "John",
        "lastName": "Doe",
        "phoneNumbers": [
          {
            "number": "+49 7163307056",
            "type": "MOBILE"
          }
        ],
        "salutation": "Mr"
      }
    ],
    "contactType": "CONTACT_PERSON",
    "createdDate": "2025-06-01T11:09:11.533Z",
    "emailAddresses": [
      {
        "email": "john.doe@company.com",
        "type": "BUSINESS"
      }
    ],
    "isCustomer": true,
    "isSupplier": false,
    "number": "1042",
    "phoneNumbers": [
      {
        "number": "+49 7163307056",
        "type": "MOBILE"
      }
    ],
    "projectId": "3",
    "updatedDate": "2025-06-01T11:09:11.533Z",
    "website": "https://www.maesn.com"
  }
}

Field support per integration

AbaConnect

This endpoint is asynchronous. If the request has not completed, the response returns a taskId. Use /asyncTask/{taskId} to check the task status and obtain the final result once it is ready.

Supported Request Parameters:

addresses

Address[]

Show properties

addressLine1

string

postalCode

string

city

string

countryCode

enum

Available options (ISO 3166-1 alpha-2):AD, AE, AF, AG, AI, AL, AM, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, YE, YT, ZA, ZM, ZW

type

enum

Available options: BILLING

companyName

string

contactType

enum

required

Available options: CONTACT_PERSON, COMPANY

contactPersons

ContactPerson[]

Show properties

firstName

string

lastName

string

emailAddresses

EmailAddress[]

Show properties

string

type

enum

Available options: BUSINESS

phoneNumbers

PhoneNumber[]

Show properties

number

string

type

enum

Available options: BUSINESS, MOBILE

emailAddresses

EmailAddress[]

Show properties

string

type

enum

Available options: BUSINESS

number

string

required

phoneNumbers

PhoneNumber[]

Show properties

number

string

type

enum

Available options: BUSINESS, PRIVATE

bexio

Supported Request Parameters:

addresses

Address[]

Show properties

addressLine1

string

postalCode

string

city

string

countryCode

enum

type

enum

Available options: BILLING

companyName

string

contactPersons

ContactPerson[]

Please note that bexio doesn’t allow contact persons for a company.

Show properties

salutation

string

Available options: Frau, Herr, Familie, Herr & Frau

firstName

string

lastName

string

required

emailAddresses

string[]

phoneNumbers

string[]

contactType

enum

required

Available options: CONTACT_PERSON, COMPANY

emailAddresses

EmailAddress[]

Show properties

string

type

enum

Available options: BUSINESS

phoneNumbers

PhoneNumber[]

Show properties

number

string

type

enum

Available options: BUSINESS, MOBILE

website

string

Exact

If you’re not using the Interactive Authentication Flow, make sure the query parameter companyId is correctly populated. You can obtain this value by using the GET Companies endpoint available under the Authentication section.

Supported Request Parameters:

addresses

Address[]

Show properties

addressLine1

string

addressLine2

string

city

string

countryCode

enum

The country code in ISO 3166-1 alpha-2 format. For a complete list of available values, see our standardized data section.

postalCode

string

type

enum

Available options: BILLING

companyName

string

required

contactPersons

ContactPerson[]

Show properties

salutation

string

firstName

string

required

lastName

string

required

emailAddresses

EmailAddress[]

Show properties

string

type

enum

Available options: BUSINESS

phoneNumbers

PhoneNumber[]

Show properties

number

string

type

enum

Available options: BUSINESS, MOBILE

contactType

enum

required

Available options:COMPANY

emailAddresses

EmailAddress[]

Show properties

string

type

enum

Available options: BUSINESS

isCustomer

boolean

isSupplier

boolean

phoneNumbers

PhoneNumber[]

Show properties

number

string

type

enum

Available options: BUSINESS

website

string

Moneybird

Supported Request Parameters:

addresses

Address[]

Show properties

addressLine1

string

addressLine2

string

city

string

countryCode

enum

The country code in ISO 3166-1 alpha-2 format. For a complete list of available values, see our standardized data section.

postalCode

string

type

enum

Available options: BILLING

companyName

string

required

contactPersons

ContactPerson[]

Show properties

firstName

string

required

lastName

string

required

emailAddresses

EmailAddress[]

Show properties

string

type

enum

Available options: BUSINESS

phoneNumbers

PhoneNumber[]

Show properties

number

string

type

enum

Available options: BUSINESS

contactType

enum

required

Available options:COMPANY, CONTACT_PERSON

emailAddresses

EmailAddress[]

Show properties

string

type

enum

Available options: BUSINESS

phoneNumbers

PhoneNumber[]

Show properties

number

string

type

enum

Available options: BUSINESS

Snelstart

Supported Request Parameters:

addresses

Address[]

Show properties

addressLine1

string

postalCode

string

city

string

countryCode

enum

required

The country code in ISO 3166-1 alpha-2 format. For a complete list of available values, see our standardized data section.

type

enum

Available options: BILLING, DELIVERY

companyName

string

required

contactType

enum

required

Available options: COMPANY

emailAddresses

EmailAddress[]

Show properties

string

type

enum

Available options:BUSINESS

isCustomer

boolean

isSupplier

boolean

number

string

phoneNumbers

PhoneNumber[]

Show properties

number

string

type

enum

Available options: BUSINESS, MOBILE

Headers

X-API-KEY

string

required

API key

X-ACCOUNT-KEY

string

required

Account key

Query Parameters

companyId

string

environmentName

string

Body

application/json

contactType

enum<string>

required

Available options:

CONTACT_PERSON,

COMPANY

Example:

"CONTACT_PERSON"

string

Example:

"92c4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b"

addresses

object[]

Show child attributes

companyName

string

Example:

"maesn"

contactPersons

object[]

Show child attributes

emailAddresses

object[]

Show child attributes

isCustomer

boolean

Example:

true

isSupplier

boolean

Example:

false

number

string

Example:

"1042"

phoneNumbers

object[]

Show child attributes

projectId

string

Example:

"3"

website

string

Example:

"https://www.maesn.com"

Response

201 - application/json

Get started

Guides

Integrations

Use cases

API reference

Create contact

Field support per integration

Headers

Query Parameters

Body

Response

Get started

Guides

Integrations

Use cases

API reference

​Field support per integration

Headers

Query Parameters

Body

Response

Field support per integration