Update your account

put

https://api.linode.com/{apiVersion}/account

Updates contact and billing information related to your account. If you exclude any properties from the request, the operation leaves them unchanged.

📘
When updating an account's country to US, you'll get an error if the account's zip is not a valid US zip code.

Parent and child accounts

In the context of the parent and child accounts feature:

You can't change the company for a parent account.
Child account users can't run this operation.

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

Identity and access permissions. Your user needs a role with these permissions. Learn more.
- Permissions: update_account
OAuth scopes. Your user needs these scopes assigned. Learn more.
- Scopes: account:read_write

CLI

linode-cli account update \
  --address_1 "123 Main St." \
  --address_2 "Suite 101" \
  --city Philadelphia \
  --company My Company \ LLC \
  --country US \
  --email jsmith@mycompany.com \
  --first_name John \
  --last_name Smith \
  --phone 555-555-1212 \
  --state PA \
  --tax_id ATU99999999 \
  --zip 19102

Learn more

Path Params

apiVersion

string

enum

required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:

Body Params

address_1

string

length ≤ 64

The first line of this account's billing address.

address_2

string

length ≤ 64

The second line of this account's billing address.

city

string

length ≤ 24

The city for this account's address.

company

string

length ≤ 128

The company name assigned to this account. This value can't include the characters, < > ( ) " =.

country

string

The two-letter ISO 3166 country code for this account's address.

string

length ≤ 128

The email address of the person assigned to this account.

first_name

string

length ≤ 50

The first name of the person assigned to this account. This value can't include the characters, < > ( ) " =.

last_name

string

length ≤ 50

The last name of the person assigned to this account. This value can't include the characters, < > ( ) " =.

phone

string

length ≤ 32

The phone number assigned to this account.

state

string

length ≤ 24

The state or province for the address set for your account, if applicable.

If the address is in the United States (US) or Canada (CA), this is the two-letter ISO 3166 code for the state or province.
If it's a US military address, this is the abbreviation for that territory. This includes AA for Armed Forces Americas (excluding Canada), AE for Armed Forces Africa, Europe, Middle East, and Canada, or AP for Armed Forces Pacific.
If outside the US or CA, this is the province associated with the account's address.

tax_id

string

length ≤ 25

The tax identification number (TIN) assigned to this account, used for tax calculations. A TIN is set by the national authorities in your country, based on your address_1, and it may be named differently between countries. Set to an empty string ("") if a TIN doesn't apply or for countries that don't collect tax.

📘
This value is externally validated. If the validation is successful, a tax_id_valid event is triggered. If unsuccessful, a tax_id_invalid event is triggered and an error response is issued for an operation that included it.

zip

string

The zip code for this account's address.

It can only contain ASCII letters, numbers, and dashes (-).
It can't contain more than nine letter or number characters.

Responses

Response body

object

active_promotions

array of objects

active_promotions

object

credit_monthly_cap

string

The amount available to spend per month.

credit_remaining

string

The total amount of credit left for this promotion.

description

string

A detailed description of this promotion.

expire_dt

string

When this promotion's credits expire.

image_url

string

The location of an image for this promotion.

service_type

string

enum

The service to which this promotion applies.

all backup blockstorage db_mysql ip_v4 linode linode_disk linode_memory longview managed nodebalancer objectstorage placement_group transfer_tx

summary

string

Short details of this promotion.

this_month_credit_remaining

string

The amount of credit left for this month for this promotion.

active_since

date-time

Read-only The date and time the account was activated.

address_1

string

length ≤ 64

The first line of this account's billing address.

address_2

string

length ≤ 64

The second line of this account's billing address.

balance

number

Read-only This account's balance, in US dollars.

balance_uninvoiced

number

Read-only This account's current estimated invoice in US dollars. This is not your final invoice balance. Transfer charges are not included in the estimate.

billing_source

string

enum

Read-only The source of service charges for this account. Accounts that are associated with Akamai-specific customers return a value of akamai. All other accounts return a value of linode.

akamai linode

capabilities

array of strings

Read-only The Akamai Cloud Computing services your account supports.

capabilities

city

string

length ≤ 24

The city for this account's address.

company

string

length ≤ 128

The company name assigned to this account. This value can't include the characters, < > ( ) " =.

country

string

The two-letter ISO 3166 country code for this account's address.

credit_card

object

Read-only The credit card information assigned to this account.

expiry

string | null

The expiration month and year of the credit_card.

last_four

string | null

The last four digits of the credit_card assigned to this account.

string

length ≤ 128

The email address of the person assigned to this account.

euuid

uuid

Read-only An external unique identifier for this account.

first_name

string

length ≤ 50

The first name of the person assigned to this account. This value can't include the characters, < > ( ) " =.

last_name

string

length ≤ 50

The last name of the person assigned to this account. This value can't include the characters, < > ( ) " =.

phone

string

length ≤ 32

The phone number assigned to this account.

state

string

length ≤ 24

The state or province for the address set for your account, if applicable.

If the address is in the United States (US) or Canada (CA), this is the two-letter ISO 3166 code for the state or province.
If it's a US military address, this is the abbreviation for that territory. This includes AA for Armed Forces Americas (excluding Canada), AE for Armed Forces Africa, Europe, Middle East, and Canada, or AP for Armed Forces Pacific.
If outside the US or CA, this is the province associated with the account's address.

tax_id

string

length ≤ 25

📘
This value is externally validated. If the validation is successful, a tax_id_valid event is triggered. If unsuccessful, a tax_id_invalid event is triggered and an error response is issued for an operation that included it.

zip

string

The zip code for this account's address.

It can only contain ASCII letters, numbers, and dashes (-).
It can't contain more than nine letter or number characters.

Language

Credentials


xxxxxxxxxx
1
curl --request PUT \
2
     --url https://api.linode.com/v4/account \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'


xxxxxxxxxx
43
 
1
{
2
  "active_promotions": [
3
    {
4
      "credit_monthly_cap": "10.00",
5
      "credit_remaining": "50.00",
6
      "description": "Receive up to $10 off your services every month for 6 months! Unused credits will expire once this promotion period ends.",
7
      "expire_dt": "2018-01-31T23:59:59",
8
      "image_url": "https://linode.com/10_a_month_promotion.svg",
9
      "service_type": "all",
10
      "summary": "$10 off your Linode a month!",
11
      "this_month_credit_remaining": "10.00"
12
    }
13
  ],
14
  "active_since": "2018-01-01T00:01:01",
15
  "address_1": "123 Main Street",
16
  "address_2": "Suite A",
17
  "balance": 200,
18
  "balance_uninvoiced": 145,
19
  "billing_source": "akamai",
20
  "capabilities": [
21
    "Linodes",
22
    "NodeBalancers",
23
    "Block Storage",
24
    "Object Storage",
25
    "Placement Groups",
26
    "Block Storage Encryption"
27
  ],
28
  "city": "Philadelphia",
29
  "company": "Linode LLC",
30
  "country": "US",
31
  "credit_card": {
32
    "expiry": "11/2022",
33
    "last_four": 1111
34
  },
35
  "email": "mrossi@linode.com",
36
  "euuid": "E1AF5EEC-526F-487D-B317EBEB34C87D71",
37
  "first_name": "John",
38
  "last_name": "Smith",
39
  "phone": "215-555-1212",
40
  "state": "PA",
41
  "tax_id": "ATU99999999",
42
  "zip": "19102-1234"
43
}

200The updated account.

defaultSee Errors for the range of possible error response codes.