--- title: "Update accounts" method: POST path: "/api/connector/v1/accounts/update" tags: ["Accounts"] --- # Update accounts `POST /api/connector/v1/accounts/update` Updates one or more existing accounts in the system. Note this operation supports [Portfolio Access Tokens](https://mews-systems.gitbook.io/connector-api/concepts/multi-property). ## Request body - MultipleAccountUpdateParameters - `ClientToken` string, required — Token identifying the client application. - `AccessToken` string, required — Access token of the client application. - `Client` string, required — Name and version of the client application. - `ChainId` string, uuid, nullable — Unique identifier of the chain. Required when using [Portfolio Access Tokens](https://mews-systems.gitbook.io/connector-api/concepts/multi-property), ignored otherwise. - `AccountUpdates` AccountUpdateParameters[], required — Accounts to be updated. - `Id` string, uuid, required — Unique identifier of the account. - `Discriminator` 'Customer' | 'Company', required — Customer Company - `Customer` AccountCustomerUpdateParameters - `Email` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `TaxIdentifier` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `BillingCode` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `AccountingCode` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `Notes` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `LastName` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `FirstName` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `SecondLastName` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `BirthPlace` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `Telephone` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `Occupation` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `CarRegistrationNumber` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `DietaryRequirements` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `LoyaltyCode` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `NationalityCode` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `CompanyId` GuidNullableUpdateValue - `Value` string, uuid, nullable — Value which is to be updated. - `BirthDate` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `Sex` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `Title` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `PreferredLanguageCode` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `Options` CustomerOptionUpdateParameters - `SendMarketingEmails` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `Invoiceable` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `BillAddressObjection` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `Classifications` CustomerClassificationUpdateParameters - `PaymasterAccount` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `Blacklist` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `Blocklist` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `Media` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `LoyaltyProgram` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `PreviousComplaint` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `Returning` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `Staff` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `FriendOrFamily` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `TopManagement` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `Important` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `VeryImportant` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `Problematic` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `Cashlist` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `DisabledPerson` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `Military` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `Airline` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `HealthCompliant` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `InRoom` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `WaitingForRoom` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `Student` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `LegalEntityIdentifiers` LegalEntityIdentifierUpdateParameters - `ItDestinationCode` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `ItFiscalCode` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `ItLotteryCode` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `Company` AccountCompanyUpdateParameters - `Email` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `TaxIdentifier` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `BillingCode` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `AccountingCode` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `Notes` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `Name` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `MotherCompanyId` GuidNullableUpdateValue - `Value` string, uuid, nullable — Value which is to be updated. - `WebsiteUrl` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `InvoiceDueInterval` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `Classifications` CompanyClassificationUpdateParameters - `Corporate` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `Internal` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `Private` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `OnlineTravelAgency` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `GlobalDistributionSystem` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `Marketing` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `Inactive` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `GovernmentEntity` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `Options` CompanyOptionUpdateParameters — Options of the company. - `Invoiceable` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `AddFeesToInvoices` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `AddTaxDeductedPaymentToInvoices` BooleanUpdateValue - `Value` boolean — Value which is to be updated. - `CreditRatingBasic` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `Department` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `DunsNumber` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `ReferenceId` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `ExternalIdentifier` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `AdditionalTaxIdentifier` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `Contact` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `ContactPerson` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `FiscalIdentifier` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `Iata` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `Telephone` StringUpdateValue - `Value` string, nullable — Value which is to be updated. - `SourceId` GuidNullableUpdateValue - `Value` string, uuid, nullable — Value which is to be updated. ## Response `200` OK - AccountResult - `Accounts` Account[], required — Updated accounts. - `Id` string, uuid, required — Unique identifier of the account. - `Discriminator` 'Company' | 'Customer', required — A discriminator specifying the account type, e.g. `Customer` or `Company` Company Customer - `Customer` CustomerAccount — Updated customer data. - `ChainId` string, uuid, required — Unique identifier of the chain. - `CreatedUtc` string, date-time, required — Creation date and time of the customer in UTC timezone in ISO 8601 format. - `UpdatedUtc` string, date-time, required — Last update date and time of the customer in UTC timezone in ISO 8601 format. - `UpdaterProfileId` string, uuid, required — Unique identifier of the user who updated the customer. - `Email` string, email, nullable — Email address of the customer. - `TaxIdentifier` string, nullable — Tax identification number of the customer. - `BillingCode` string, nullable — Billing code of the customer. - `AccountingCode` string, nullable — Accounting code of the customer. - `Notes` string, nullable — Internal notes about the customer. - `LastName` string, required — Last name of the customer. - `FirstName` string, nullable — First name of the customer. - `SecondLastName` string, nullable — Second last name of the customer. - `BirthPlace` string, nullable — Place of birth. - `Telephone` string, nullable — Telephone number of the customer (possibly mobile). - `Occupation` string, nullable — Occupation of the customer. - `CarRegistrationNumber` string, nullable — Registration number of the customer's car. - `DietaryRequirements` string, nullable — Dietary requirements of the customer. - `LoyaltyCode` string, nullable — Loyalty code of the customer. - `NationalityCode` string, nullable — ISO 3166-1 code of the `Country`. - `CompanyId` string, uuid, nullable — Unique identifier of `Company` the customer is associated with. - `BirthDate` string, date-time, nullable — Date of birth in ISO 8601 format. - `Sex` string, nullable — Sex of the customer. - `Title` 'Mister' | 'Miss' | 'Misses' — Type of the title prefix of the customer. Note that the value should not be used as-is, but localized. For example, the value `Misses` should be displayed as `Mrs.` in English and `Fr.` in German. Mister (Mr.) Miss (Ms.) Misses (Mrs.) - `CustomTitleName` string, nullable — Name of the customer's custom title, as configured in the chain's guest titles. Mutually exclusive with `Title`. - `PreferredLanguageCode` string, nullable — Language and culture code of the customer's preferred language. E.g. `en-US` or `fr-FR`. - `Options` CustomerAccountOptions, required - `SendMarketingEmails` boolean — Send marketing emails. - `Invoiceable` boolean — Invoiceable. - `BillAddressObjection` boolean — Bill address objection. - `Classifications` CustomerAccountClassifications, required - `PaymasterAccount` boolean — Paymaster account. - `Blacklist` boolean — Synonym of Blocklist, left for backward compatibility. - `Blocklist` boolean — Blocklist. - `Media` boolean — Media. - `LoyaltyProgram` boolean — Loyalty program. - `PreviousComplaint` boolean — Previous complaint. - `Returning` boolean — Returning. - `Staff` boolean — Staff. - `FriendOrFamily` boolean — Friend or family. - `TopManagement` boolean — Top management. - `Important` boolean — Important. - `VeryImportant` boolean — Very important. - `Problematic` boolean — Problematic. - `Cashlist` boolean — Cash list. - `DisabledPerson` boolean — Disabled person. - `Military` boolean — Military. - `Airline` boolean — Airline. - `HealthCompliant` boolean — Health compliant. - `InRoom` boolean — In room. - `WaitingForRoom` boolean — Waiting for room. - `Student` boolean — Student. - `LegalEntityIdentifiers` LegalEntityIdentifiers, required - `ItDestinationCode` string, nullable — Italian destination code. - `ItFiscalCode` string, nullable — Italian fiscal code. - `ItLotteryCode` string, nullable — Italian lottery code. - `Company` CompanyAccount - `ChainId` string, uuid, required — Unique identifier of the chain. - `CreatedUtc` string, date-time, required — Creation date and time of the `Company` in UTC timezone in ISO 8601 format. - `UpdatedUtc` string, date-time, required — Last update date and time of the `Company` in UTC timezone in ISO 8601 format. - `UpdaterProfileId` string, uuid, required — Unique identifier of the user who updated the company. - `Email` string, email, nullable — Email address of the company. - `TaxIdentifier` string, nullable — Tax identification number of the company. - `BillingCode` string, nullable — Billing code of the company. - `AccountingCode` string, nullable — Accounting code of the company. - `Notes` string, nullable — Additional notes. - `Name` string, required — Name of the company. - `MotherCompanyId` string, uuid, nullable — Unique identifier of mother company. - `WebsiteUrl` string, uri, nullable — The website url of the company. - `InvoiceDueInterval` string, nullable — The maximum time (in ISO 8601 duration format), when the invoice has to be be paid. - `CreditRatingBasic` 'CreditOk' | 'PaymentRequiredUpfront' | 'LocalDecisionRequired' — CreditOk (Company can book services.) PaymentRequiredUpfront (Company must pay upfront.) LocalDecisionRequired (Requires local approval.) - `Department` string, nullable — The internal segmentation of a company, e.g. sales department. - `DunsNumber` string, nullable — The Dun & Bradstreet unique 9-digit DUNS number. - `ReferenceId` string, nullable — External system identifier - custom identifier used by an external system such as an external database. - `ExternalIdentifier` string, nullable — Identifier of company from external system. - `AdditionalTaxIdentifier` string, nullable — Additional tax identifier of the company. - `Contact` string, nullable — Other contact details, such as telephone, email or similar. - `ContactPerson` string, nullable — Contact person of the company. - `FiscalIdentifier` string, nullable — Fiscal identifier of the company. - `Iata` string, nullable — Iata of the company. - `Telephone` string, nullable — Contact telephone number. - `SourceId` string, uuid, nullable — Unique identifier of the `Source`. - `Classifications` CompanyAccountClassifications, required - `Corporate` boolean — Corporate. - `Internal` boolean — Internal. - `Private` boolean — Private. - `OnlineTravelAgency` boolean — Online travel agency. - `GlobalDistributionSystem` boolean — Global distribution system. - `Marketing` boolean — Marketing. - `Inactive` boolean — Inactive. - `GovernmentEntity` boolean — Government Entity - `Options` CompanyAccountOptions, required - `Invoiceable` boolean — Whether the company is invoiceable or not. - `AddFeesToInvoices` boolean — Whether the company has an additional fee applied for invoicing or not. - `AddTaxDeductedPaymentToInvoices` boolean — Whether tax-deducted payments should be automatically added to invoices. ## Other responses - `204` — Server has successfully fulfilled the request and there is no additional information to send back. - `400` — Error caused by the client app, e.g. in case of malformed request or invalid identifier of a resource. In most cases, such an error signifies a bug in the client app (consumer of the API). - `401` — Error caused by usage of invalid ClientToken, AccessToken, or you may not have the necessary permission to use the endpoint. - `403` — Server error that should be reported to the end user of the client app. Happens for example when the server-side validation fails or when a business-logic check is violated. - `408` — Error caused by heavy request that takes too long to process (typically tens of seconds). To get around this, request data in smaller batches. For more information, see [Request timeouts](https://mews-systems.gitbook.io/connector-api/guidelines/requests#request-timeouts) - `429` — Error caused by too many requests sent in a given amount of time. Response contains `Retry-After` header indicating how long the user agent should wait before making a follow-up request. For more information, see [Request limits](https://mews-systems.gitbook.io/connector-api/guidelines/requests#request-limits). - `500` — Unexpected error on the Mews side. This may be due to a software fault. If such a situation occurs, the error will be logged and the development team notified, however you can raise an issue through GitHub on our [documentation repository](https://github.com/MewsSystems/gitbook-connector-api). --- [API](https://skmtc.net/mews/apis/connector-api.md) · [All operations](https://skmtc.net/mews/apis/connector-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mews/connector-api/revisions/f37f136ed35a/schema)