Save the tenant's own company profile (tenant:settings:write)
PUT /api/masterdata/tenant-profile
Module: Master data · operationId: saveTenantProfile · Tag: Settings · Auth: access token (Authorization: Bearer <accessToken>)
version 0 creates the profile (409 if one exists), otherwise version must match the
stored one. The VAT ID is used for official VAT checks, the country decides whether addresses
are foreign. Emits masterdata.tenant_profile.updated.
Request body
application/json (required)
companyName(string, required): Company name of the tenant (max length 255)version(integer, required): 0 creates the profile; otherwise the version you readcity(string): City (max length 128)commercialRegister(string): Commercial register number (max length 128)companyNameAddition(string): Company name addition (max length 255)countryCode(string): Country (ISO 3166-1 alpha-2); decides whether addresses are foreign (default"DE")defaultBankName(string): Name of the default bank (max length 128)defaultBic(string): BIC of the default bank accountdefaultIban(string): IBAN of the default bank accountemail(string (email)): E-mail address (max length 255)geocodePrecision(string, read-only): SeePostalAddress.geocodePrecision(one ofHOUSE,STREET,LOCALITY,POSTCODE)geocodeStatus(string, read-only): SeePostalAddress.geocodeStatus(one ofPENDING,DONE,FAILED,SKIPPED)glAccountLength(integer, nullable): Length g of the G/L accounts; unset: account numbers of addresses are not checked. Changing it never fails because of existing addresses (max 8)invoiceContactEmail(string (email)): E-mail of the invoice contact (BT-43); empty:invoiceEmail, elseemail(max length 255)invoiceContactName(string): Contact person outgoing invoices name (XRechnung BT-41, required there) (max length 128)invoiceContactPhone(string): Phone of the invoice contact (BT-42); empty:phone(max length 64)invoiceEmail(string (email)): Electronic address of the seller on outgoing e-invoices (BT-34, scheme EM); empty:email(max length 255)latitude(number, nullable, read-only): WGS 84, geocoded from the address like a postal address (origin of distances); ignored on writeslongitude(number, nullable, read-only): WGS 84managingDirectors(string): Managing directors (max length 255)phone(string): Phone (max length 64)postalCode(string): Postal code (max length 32)registerCourt(string): Register court (max length 128)sepaCreditorId(string): SEPA creditor identifier (max length 35)street(string): Street with house number (max length 255)taxNumber(string): Tax number (max length 64)updatedAt(string (date-time), read-only): Time of the last changevatId(string): VAT ID of the tenant (used for official VAT checks)website(string): Website (max length 255)
Example:
{
"city": "Regensburg",
"commercialRegister": "HRB 99999",
"companyName": "Muster IT-Systemhaus GmbH",
"countryCode": "DE",
"defaultBankName": "Stadtsparkasse München",
"defaultBic": "SSKMDEMMXXX",
"defaultIban": "DE66701500000001234567",
"email": "info@muster-it.example",
"geocodePrecision": "HOUSE",
"geocodeStatus": "DONE",
"glAccountLength": 4,
"invoiceContactEmail": "christina.adler@muster-it.example",
"invoiceContactName": "Christina Adler",
"invoiceContactPhone": "+4994112345015",
"invoiceEmail": "rechnungen@muster-it.example",
"latitude": 49.0134,
"longitude": 12.1325,
"managingDirectors": "Thomas Pfeiffer",
"phone": "+49941123450",
"postalCode": "93055",
"registerCourt": "Amtsgericht Regensburg",
"street": "Industriestraße 12",
"updatedAt": "2026-06-01T10:00:00Z",
"vatId": "DE999000111",
"version": 4,
"website": "https://www.muster-it.example"
}
Responses
- 200 Saved (
application/json) - 400 Malformed body or query parameter (
application/json) - 401 Missing, invalid or expired token (empty body)
- 403 The token lacks the permission or carries no tenant (
application/json) - 409 Stale version or conflict with existing data (
application/json)
Fields of the 200 answer:
companyName(string, required): Company name of the tenant (max length 255)version(integer, required): 0 creates the profile; otherwise the version you readcity(string): City (max length 128)commercialRegister(string): Commercial register number (max length 128)companyNameAddition(string): Company name addition (max length 255)countryCode(string): Country (ISO 3166-1 alpha-2); decides whether addresses are foreign (default"DE")defaultBankName(string): Name of the default bank (max length 128)defaultBic(string): BIC of the default bank accountdefaultIban(string): IBAN of the default bank accountemail(string (email)): E-mail address (max length 255)geocodePrecision(string, read-only): SeePostalAddress.geocodePrecision(one ofHOUSE,STREET,LOCALITY,POSTCODE)geocodeStatus(string, read-only): SeePostalAddress.geocodeStatus(one ofPENDING,DONE,FAILED,SKIPPED)glAccountLength(integer, nullable): Length g of the G/L accounts; unset: account numbers of addresses are not checked. Changing it never fails because of existing addresses (max 8)invoiceContactEmail(string (email)): E-mail of the invoice contact (BT-43); empty:invoiceEmail, elseemail(max length 255)invoiceContactName(string): Contact person outgoing invoices name (XRechnung BT-41, required there) (max length 128)invoiceContactPhone(string): Phone of the invoice contact (BT-42); empty:phone(max length 64)invoiceEmail(string (email)): Electronic address of the seller on outgoing e-invoices (BT-34, scheme EM); empty:email(max length 255)latitude(number, nullable, read-only): WGS 84, geocoded from the address like a postal address (origin of distances); ignored on writeslongitude(number, nullable, read-only): WGS 84managingDirectors(string): Managing directors (max length 255)phone(string): Phone (max length 64)postalCode(string): Postal code (max length 32)registerCourt(string): Register court (max length 128)sepaCreditorId(string): SEPA creditor identifier (max length 35)street(string): Street with house number (max length 255)taxNumber(string): Tax number (max length 64)updatedAt(string (date-time), read-only): Time of the last changevatId(string): VAT ID of the tenant (used for official VAT checks)website(string): Website (max length 255)
Example 200 answer:
{
"city": "Regensburg",
"commercialRegister": "HRB 99999",
"companyName": "Muster IT-Systemhaus GmbH",
"countryCode": "DE",
"defaultBankName": "Stadtsparkasse München",
"defaultBic": "SSKMDEMMXXX",
"defaultIban": "DE66701500000001234567",
"email": "info@muster-it.example",
"geocodePrecision": "HOUSE",
"geocodeStatus": "DONE",
"glAccountLength": 4,
"invoiceContactEmail": "christina.adler@muster-it.example",
"invoiceContactName": "Christina Adler",
"invoiceContactPhone": "+4994112345015",
"invoiceEmail": "rechnungen@muster-it.example",
"latitude": 49.0134,
"longitude": 12.1325,
"managingDirectors": "Thomas Pfeiffer",
"phone": "+49941123450",
"postalCode": "93055",
"registerCourt": "Amtsgericht Regensburg",
"street": "Industriestraße 12",
"updatedAt": "2026-06-01T10:00:00Z",
"vatId": "DE999000111",
"version": 4,
"website": "https://www.muster-it.example"
}
Example request
curl -X PUT 'https://api.mbcom.cloud/api/masterdata/tenant-profile' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data '{"city":"Regensburg","commercialRegister":"HRB 99999","companyName":"Muster IT-Systemhaus GmbH","countryCode":"DE","defaultBankName":"Stadtsparkasse München","defaultBic":"SSKMDEMMXXX","defaultIban":"DE66701500000001234567","email":"info@muster-it.example","geocodePrecision":"HOUSE","geocodeStatus":"DONE","glAccountLength":4,"invoiceContactEmail":"christina.adler@muster-it.example","invoiceContactName":"Christina Adler","invoiceContactPhone":"+4994112345015","invoiceEmail":"rechnungen@muster-it.example","latitude":49.0134,"longitude":12.1325,"managingDirectors":"Thomas Pfeiffer","phone":"+49941123450","postalCode":"93055","registerCourt":"Amtsgericht Regensburg","street":"Industriestraße 12","updatedAt":"2026-06-01T10:00:00Z","vatId":"DE999000111","version":4,"website":"https://www.muster-it.example"}'