Skip to main content
PATCH
/
accounting
/
v2
/
contacts
/
{contactId}
cURL
curl --request PATCH \
  --url https://api.maesn.dev/accounting/v2/contacts/{contactId} \
  --header 'Content-Type: application/json' \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>' \
  --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": "[email protected]",
          "type": "BUSINESS"
        }
      ],
      "firstName": "John",
      "lastName": "Doe",
      "phoneNumbers": [
        {
          "number": "+49 7163307056",
          "type": "MOBILE"
        }
      ],
      "salutation": "Mr"
    }
  ],
  "contactType": "CONTACT_PERSON",
  "emailAddresses": [
    {
      "email": "[email protected]",
      "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": "[email protected]",
            "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": "[email protected]",
        "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

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[]
​
companyName
string
​
contactPersons
ContactPerson[]
​
contactType
enum
Available options:COMPANY, CONTACT_PERSON
​
emailAddresses
EmailAddress[]
​
phoneNumbers
PhoneNumber[]

Headers

​
X-API-KEY
string
required

API key

​
X-ACCOUNT-KEY
string
required

Account key

Path Parameters

​
contactId
string
required

Body

application/json
​
id
string
Example:

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

​
addresses
object[]
​
companyName
string
Example:

"maesn"

​
contactPersons
object[]
​
contactType
enum<string>
Available options:
CONTACT_PERSON,
COMPANY
Example:

"CONTACT_PERSON"

​
emailAddresses
object[]
​
isCustomer
boolean
Example:

true

​
isSupplier
boolean
Example:

false

​
number
string
Example:

"1042"

​
phoneNumbers
object[]
​
projectId
string
Example:

"3"

​
website
string
Example:

"https://www.maesn.com"

Response

201 - application/json
​
meta
object
​
data
object