Get started
Integrations
Use cases
API reference
- Accounting
- Authentication
- Tenant Management
- User
Create contact
POST
/
accounting
/
contacts
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",
"companyName": "Company name",
"contactPersons": [
{
"salutation": "Mr",
"firstName": "John",
"lastName": "Doe",
"emailAddresses": [
"john.doe@company.com"
],
"phoneNumbers": [
"+49 7163307056"
]
}
],
"addresses": [
{
"addressLine1": "Street",
"addressLine2": "Building",
"postalCode": "12345",
"city": "City",
"countryCode": "DE",
"type": "BILLING"
}
],
"emailAddresses": [
{
"email": "john.doe@company.com",
"type": "BUSINESS"
}
],
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
],
"bankAccount": {
"iban": "DE89370400440532013000",
"bic": "COBADEFFXXX",
"holder": "John Doe",
"sepa": true
},
"projectId": "1"
}'{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "1",
"contactType": "CONTACT_PERSON",
"companyName": "Company name",
"contactPersons": [
{
"salutation": "Mr",
"firstName": "John",
"lastName": "Doe",
"emailAddresses": [
{
"email": "john.doe@company.com",
"type": "BUSINESS"
}
],
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
]
}
],
"addresses": [
{
"addressLine1": "Street",
"addressLine2": "Building",
"postalCode": "12345",
"city": "City",
"countryCode": "DE",
"type": "BILLING"
}
],
"emailAddresses": [
{
"email": "john.doe@company.com",
"type": "BUSINESS"
}
],
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
],
"projectId": "1",
"updatedDate": "2018-01-01T13:00:00.000Z"
}
}Test Api token:
663222ee33ebba4015340680c7685723a0703c2ad953cefaa1536dc1bac02e20
Test Account token:
85b30b510f09120b199a4dbd9111ff7b3aaf28f1f72701418e111a551fb77b4c
Body
application/json
Available options:
CONTACT_PERSON, COMPANY Available options:
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 Available options:
BILLING, DELIVERY, EMPTY, PRIVATE, WORK, PICKUP Response
200 - application/json
Available options:
CONTACT_PERSON, COMPANY Available options:
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 Available options:
BILLING, DELIVERY, EMPTY, PRIVATE, WORK, PICKUP Was this page helpful?
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",
"companyName": "Company name",
"contactPersons": [
{
"salutation": "Mr",
"firstName": "John",
"lastName": "Doe",
"emailAddresses": [
"john.doe@company.com"
],
"phoneNumbers": [
"+49 7163307056"
]
}
],
"addresses": [
{
"addressLine1": "Street",
"addressLine2": "Building",
"postalCode": "12345",
"city": "City",
"countryCode": "DE",
"type": "BILLING"
}
],
"emailAddresses": [
{
"email": "john.doe@company.com",
"type": "BUSINESS"
}
],
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
],
"bankAccount": {
"iban": "DE89370400440532013000",
"bic": "COBADEFFXXX",
"holder": "John Doe",
"sepa": true
},
"projectId": "1"
}'{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "1",
"contactType": "CONTACT_PERSON",
"companyName": "Company name",
"contactPersons": [
{
"salutation": "Mr",
"firstName": "John",
"lastName": "Doe",
"emailAddresses": [
{
"email": "john.doe@company.com",
"type": "BUSINESS"
}
],
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
]
}
],
"addresses": [
{
"addressLine1": "Street",
"addressLine2": "Building",
"postalCode": "12345",
"city": "City",
"countryCode": "DE",
"type": "BILLING"
}
],
"emailAddresses": [
{
"email": "john.doe@company.com",
"type": "BUSINESS"
}
],
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
],
"projectId": "1",
"updatedDate": "2018-01-01T13:00:00.000Z"
}
}