# Update Account Updates the current account details. Only the fields sent inside account are changed. Endpoint: PUT /api/v3/accounts Version: 3.1.0 Security: apiKeyAuth ## Query parameters: - `api_key` (string, required) Your API Key. Example: "YOUR_API_KEY" ## Request fields (application/json): - `retroactive_communication_option` (string) Optional. When the account ends up with at_communication_type auto (and is not a SAF-T big account), the documents of the chosen years are communicated to the AT retroactively. Any other value communicates nothing retroactively. Enum: "only_this_year", "this_year_and_last_year" - `account` (object, required) Required. An empty body (no account key and no top-level account field) returns 422 "Param is missing"; top-level account fields are wrapped into account automatically. Only the fields sent are changed. - `account.address_country` (string,null) ISO country code of the address. Example: "PT" - `account.billing_address_country` (string,null) ISO country code of the billing address. Example: "PT" - `account.billing_data_confirmed` (boolean) Marks the billing data as confirmed. Once confirmed it is not changed again. Example: true - `account.capital_social` (string,null) Example: "5000 EUR" - `account.conservatoria` (string,null) Example: "Lisboa" - `account.currency_id` (integer) Example: 1 - `account.decimal_marker` (string) Example: "," - `account.email` (string) Example: "billing@example.com" - `account.fiscal_region` (string,null) Cleared (set to null) when billing_country_id is sent with a country other than 1 and no fiscal_region is sent. - `account.invoice_footer` (string,null) Values longer than 200 characters are rejected with HTTP 422. Example: "Company registered in Lisbon." - `account.observations` (string,null) Values longer than 400 characters are rejected with HTTP 422. - `account.payment_mechanism` (string,null) - `account.tax_exemption_code` (string,null) Example: "M07" - `account.tax_location_id` (integer) When different from 1 and sent together with fiscal_id, the VAT number is validated for that country; an invalid one returns 422 "VAT Number is invalid". Example: 1 - `account.address` (string) Values longer than 210 characters are rejected with HTTP 422. Example: "Avenida Duque D'Ávila 46 – 3ºA" - `account.at_communication_type` (string) Example: "auto" - `account.at_subuser` (string) Example: "599999993/1" - `account.at_password` (string) Checked against the AT before saving; rejected credentials return 422 "The tax authority rejected the at_subuser/at_password combination". Example: "123456" - `account.bank_data1` (string) Example: "PT50 123456789" - `account.bank_data2` (string) Example: "1234" - `account.bank_data3` (string,null) - `account.billing_address` (string) Example: "Avenida Duque D'Ávila 46 – 3ºA" - `account.billing_city` (string) Example: "Porto" - `account.billing_country_id` (integer) Example: 1 - `account.billing_email` (string) Example: "test@example.com" - `account.billing_fiscal_id` (string) Example: "999999990" - `account.billing_organization_name` (string) Example: "Invoice Xpress" - `account.billing_postal_code` (string) Example: "1011-123" - `account.city` (string) Values longer than 50 characters are rejected with HTTP 422. Example: "Lisboa" - `account.fiscal_id` (string) Example: "508000111" - `account.iva_caixa` (boolean) Example: true - `account.language` (string) Example: "pt" - `account.organization_name` (string) Values longer than 100 characters are rejected with HTTP 422. Example: "Invoice Xpress" - `account.postal_code` (string) Example: "1011-123" ## Response 200 fields (application/json): - `account` (object) - `account.id` (integer) Example: 148306 - `account.address` (string,null) Values longer than 210 characters are rejected with HTTP 422. Example: "Avenida Duque D'Avila, Saldanha" - `account.address_country` (string,null) ISO country code of the address Example: "PT" - `account.at_communication_type` (string,null) Example: "manual" - `account.at_subuser` (string,null) Example: "12345689/0" - `account.at_configured` (boolean) Example: true - `account.billing_address` (string,null) Example: "Avenida Duque D'Avila, Saldanha" - `account.billing_city` (string,null) Example: "Lisbon" - `account.billing_country_id` (integer,null) Example: 1 - `account.billing_email` (string,null) Example: "tito.reis@visma.com" - `account.billing_fiscal_id` (string,null) Example: "999999990" - `account.billing_organization_name` (string,null) Example: "invoicexpress" - `account.billing_postal_code` (string,null) Example: "1500-555" - `account.billing_address_country` (string,null) ISO country code of the billing address Example: "PT" - `account.can_change_nif` (boolean) - `account.capital_social` (string,null) - `account.city` (string,null) Values longer than 50 characters are rejected with HTTP 422. Example: "Lisbon" - `account.conservatoria` (string,null) - `account.currency_id` (integer,null) Example: 1 - `account.decimal_marker` (string,null) Example: "," - `account.documents_from_last_year` (boolean) - `account.email` (string,null) Example: "tito.reis@visma.com" - `account.fiscal_id` (string,null) Example: "999999990" - `account.fiscal_region` (string,null) - `account.iva_caixa` (boolean) - `account.language` (string) Example: "en" - `account.logo_url` (string,null) - `account.observations` (string,null) Values longer than 400 characters are rejected with HTTP 422. - `account.organization_name` (string,null) Values longer than 100 characters are rejected with HTTP 422. Example: "invoicexpress" - `account.payment_days` (integer,null) - `account.payment_mechanism` (string,null) - `account.postal_code` (string,null) Example: "1500-555" - `account.send_options` (integer,null) - `account.state` (string) Example: "active" - `account.tax_exemption_code` (string,null) - `account.tax_location_id` (integer,null) Example: 1 - `account.trial` (boolean) ## Response 401 fields (application/json): - `errors` (array) Example: [{"error":"Authentication Error"}] - `errors.error` (string) ## Response 422 fields (application/json): - `errors` (array) Example: [{"error":"An unexpected error occurred"}] - `errors.error` (string) ## Response 500 fields (application/json): - `errors` (array) Example: [{"error":"An unexpected error occurred"}] - `errors.error` (string)