ConnectCloud Developers

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 read
  • city (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 account
  • defaultIban (string): IBAN of the default bank account
  • email (string (email)): E-mail address (max length 255)
  • geocodePrecision (string, read-only): See PostalAddress.geocodePrecision (one of HOUSE, STREET, LOCALITY, POSTCODE)
  • geocodeStatus (string, read-only): See PostalAddress.geocodeStatus (one of PENDING, 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, else email (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 writes
  • longitude (number, nullable, read-only): WGS 84
  • managingDirectors (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 change
  • vatId (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 read
  • city (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 account
  • defaultIban (string): IBAN of the default bank account
  • email (string (email)): E-mail address (max length 255)
  • geocodePrecision (string, read-only): See PostalAddress.geocodePrecision (one of HOUSE, STREET, LOCALITY, POSTCODE)
  • geocodeStatus (string, read-only): See PostalAddress.geocodeStatus (one of PENDING, 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, else email (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 writes
  • longitude (number, nullable, read-only): WGS 84
  • managingDirectors (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 change
  • vatId (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"}'

View as Markdown · Interactive reference · OpenAPI