Update the account settings
update_account_settingsIdempotent
Change the settings of the account. Send only what the user is changing: every setting you leave out keeps its value. billing_country, billing_address and intra_eu_vat_number clear when you send null; name, language and timezone keep their value on null, so name the language or the time zone you want. A postal address and a VAT number travel with billing_country: send the country in the same call. What you write here goes on the next invoices of the account, and the invoices already issued keep the details they carry.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Legal name of the account, the one printed on its invoices. | |
| language | No | The language we write to this account in: emails, and the hosted payment page of a top-up. | |
| timezone | No | The time zone the hours of the account are shown in, as an IANA identifier: "Europe/Paris", "America/New_York", "UTC". | |
| billing_address | No | Postal address of the account, one string per line, like ["12 Example Street", "75001 Paris"]. The list replaces the previous address; [] or null clears it. Three lines at most, so the address block of an invoice stays readable. | |
| billing_country | No | Billing country, as an ISO 3166-1 alpha-2 code: "FR", "US", "BR". It decides the tax treatment of the next invoices, so it is the country of the entity being billed, not where the user happens to be. | |
| intra_eu_vat_number | No | Intra-EU VAT number, for an account billed in an EU member state: the two-letter country code followed by the national number, like "FR12345678901". It goes on the invoices of the account. |