Put contact - maesn

cURL

curl --request PUT \
  --url https://api.maesn.dev/accounting/contacts/{contactId} \
  --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"
    }
  ],
  "companyName": "maesn",
  "contactPersons": [
    {
      "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"
  }
}

PUT

accounting

contacts

{contactId}

cURL

curl --request PUT \
  --url https://api.maesn.dev/accounting/contacts/{contactId} \
  --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"
    }
  ],
  "companyName": "maesn",
  "contactPersons": [
    {
      "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

Exact Online

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.

Support rawData: falseSupported 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

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

bexio

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

contactType

enum

Available options: CONTACT_PERSON, COMPANY

companyName

string

contactPersons

ContactPerson[]

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

Show properties

salutation

enum

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

firstName

string

lastName

string

emailAddresses

string[]

phoneNumbers

string[]

emailAddresses

EmailAddress[]

Show properties

string

type

enum

Available options: BUSINESS

phoneNumbers

PhoneNumber[]

Show properties

number

string

type

enum

Available options: BUSINESS, MOBILE

website

string

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

Xero

Supported Request Parameters:

adxdresses

Address[]

Show properties

addressLine1

string

addressLine2

string

postalCode

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.

type

enum

Available options: BILLING, DELIVERY

companyName

string

required

contactPersons

ContactPerson[]

Show properties

firstName

string

lastName

string

emailAddresses

EmailAddress[]

Show properties

string

emailAddresses

EmailAddress[]

Show properties

string

number

string

phoneNumbers

PhoneNumber[]

Show properties

number

string

type

enum

Available options: BUSINESS, MOBILE, FAX, OTHER

Headers

X-API-KEY

string

required

API key

X-ACCOUNT-KEY

string

required

Account key

Path Parameters

contactId

string

required

Body

application/json

contactType

enum<string>

required

Available options:

CONTACT_PERSON,

COMPANY

Example:

"CONTACT_PERSON"

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

​Field support per integration

Headers

Path Parameters

Body

Response

Field support per integration