View a markdown version of this page

Update the primary contact for your Amazon Web Services account - Amazon Account Management
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Update the primary contact for your Amazon Web Services account

These instructions are for how to update the primary contact for your Amazon Web Services account if you signed up for Amazon using Sign up for Amazon (advanced) or if you activated advanced features for your account. To compare sign-up options, see Compare sign-up options.

You can update the primary contact information associated with your account, including your contact's full name, company name, mailing address, telephone number, and website address.

You can also verify the primary contact phone number. For more information, see Verify the primary contact phone number.

You edit the primary account contact differently, depending on whether or not the accounts are standalone, or part of an organization:

  • Standalone Amazon Web Services accounts – For Amazon Web Services accounts not associated with an organization, you can update your own primary account contact using the Amazon Management Console, or via Amazon CLI & SDKs. To learn how to do this, see Update standalone Amazon Web Services account primary contact.

  • Amazon Web Services accounts within an organization – For member accounts that are part of an Amazon organization, a user in the management account or delegated admin account can centrally update any member account in the organization from the Amazon Organizations console, or programmatically via the Amazon CLI & SDKs. To learn how to do this, see Update Amazon Web Services account primary contact in your organization.

Phone number and email address requirements

Before you proceed with updating your account's primary contact information, we recommend that you first review the following requirements when entering phone numbers and email addresses.

  • Phone numbers should only contain numbers.

  • Phone numbers must start with a + and country code and must not have any leading zeros or additional spaces after the country code. For example, +1 (US/Canada) or +44 (UK).

  • Phone numbers must not include whitespaces between the area code, exchange code, and local code. For example, +12025550179.

  • For security purposes, phone numbers must be capable of receiving SMS from Amazon. Toll free numbers will not be accepted since most don't support SMS.

  • For business Amazon Web Services accounts, it's a best practice to enter a company phone number and email address rather than one belonging to an individual. Configuring the account's root user with an individual's email address or phone number can make your account difficult to recover if that individual leaves the company.

Update the primary contact for a standalone Amazon Web Services account or management account

To edit your primary contact details for a standalone Amazon Web Services account or a management account, perform the steps in the following procedure. The following Amazon Web Services Management Console procedure always works only in the standalone context. You can use the Amazon Web Services Management Console to access or change only the primary contact information of the account you used to call the operation.

Amazon Web Services Management Console
To edit your primary contact for a standalone Amazon Web Services account or management account
Minimum permissions

To perform the following steps, you must have at least the following IAM permissions:

  • account:GetContactInformation (to see the primary contact details)

  • account:PutContactInformation (to update the primary contact details)

  1. Sign in to the Amazon Web Services Management Console as an IAM user or role that has the minimum permissions.

  2. Choose your account name on the top right of the window, and then choose Account.

  3. Scroll down to the section Contact information, and next to it choose Edit.

  4. Change the values in any of the available fields.

  5. After you have made all of your changes, choose Update.

Amazon CLI & SDKs

You can retrieve, update, or delete the primary contact information by using the following Amazon CLI commands or their Amazon SDK equivalent operations:

Notes
Minimum permissions

For each operation, you must have the permission that maps to that operation:

  • account:GetContactInformation

  • account:PutContactInformation

If you use these individual permissions, you can grant some users the ability to only read the contact information, and grant others the ability to both read and write.

Example

The following example retrieves the current primary contact information for the caller's account.

$ aws account get-contact-information { "ContactInformation": { "AddressLine1": "123 Any Street", "City": "Seattle", "CompanyName": "Example Corp, Inc.", "CountryCode": "US", "DistrictOrCounty": "King", "FullName": "Saanvi Sarkar", "PhoneNumber": "+15555550100", "PostalCode": "98101", "StateOrRegion": "WA", "WebsiteUrl": "https://www.examplecorp.com" } }
Example

The following example sets new primary contact information for the caller's account.

$ aws account put-contact-information --contact-information \ '{"AddressLine1": "123 Any Street", "City": "Seattle", "CompanyName": "Example Corp, Inc.", "CountryCode": "US", "DistrictOrCounty": "King", "FullName": "Saanvi Sarkar", "PhoneNumber": "+15555550100", "PostalCode": "98101", "StateOrRegion": "WA", "WebsiteUrl": "https://www.examplecorp.com"}'

This command produces no output if it's successful.

Update the primary contact for any Amazon member account in your organization

To edit your primary contact details in any Amazon member account in your organization, perform the steps in the following procedure.

Additional requirements

To update primary contact with the Amazon Organizations console, you need to do some preliminary settings:

  • Your organization must enable all features to manage settings on your member accounts. This allows admin control over the member accounts. This is set by default when you create your organization. If your organization is set to consolidated billing only, and you want to enable all features, see Enabling all features for an organization.

  • You need to enable trusted access for the Amazon Account Management service. To set this up, see Enable trusted access for Amazon Account Management.

Amazon Web Services Management Console
To edit your primary contact for any Amazon Web Services account in your organization
  1. Sign in to the Amazon Organizations console with the organization's management account credentials.

  2. From Amazon Web Services accounts, select the account that you want to update.

  3. Choose Contact info, and locate Primary contact.

  4. Select Edit.

  5. Change the values in any of the available fields.

  6. After you have made all of your changes, choose Save.

If you change the phone number, we send a verification code to the new number when you choose Save. You can verify the number immediately or later. For more information, see Verify the phone number for a member account in your organization.

Amazon CLI & SDKs

You can retrieve, update, or delete the primary contact information by using the following Amazon CLI commands or their Amazon SDK equivalent operations:

Notes
  • To perform these operations from the management account or a delegated admin account in an organization against member accounts, you must enable trusted access for the Account service.

  • You can't access an account in a different organization from the one you are using to call the operation.

Minimum permissions

For each operation, you must have the permission that maps to that operation:

  • account:GetContactInformation

  • account:PutContactInformation

If you use these individual permissions, you can grant some users the ability to only read the contact information, and grant others the ability to both read and write.

Example

The following example retrieves the current primary contact information for the specified member account in an organization. The credentials used must be from either the organization's management account, or from the Account Management's delegated admin account.

$ aws account get-contact-information --account-id 123456789012 { "ContactInformation": { "AddressLine1": "123 Any Street", "City": "Seattle", "CompanyName": "Example Corp, Inc.", "CountryCode": "US", "DistrictOrCounty": "King", "FullName": "Saanvi Sarkar", "PhoneNumber": "+15555550100", "PostalCode": "98101", "StateOrRegion": "WA", "WebsiteUrl": "https://www.examplecorp.com" } }
Example

The following example sets the primary contact information for the specified member account in an organization. The credentials used must be from either the organization's management account, or from the Account Management's delegated admin account.

$ aws account put-contact-information --account-id 123456789012 \ --contact-information '{"AddressLine1": "123 Any Street", "City": "Seattle", "CompanyName": "Example Corp, Inc.", "CountryCode": "US", "DistrictOrCounty": "King", "FullName": "Saanvi Sarkar", "PhoneNumber": "+15555550100", "PostalCode": "98101", "StateOrRegion": "WA", "WebsiteUrl": "https://www.examplecorp.com"}'

This command produces no output if it's successful.

Verify the primary contact phone number

You can verify the phone number in the primary contact information for an Amazon Web Services account. Verifying confirms that the phone number on file can receive SMS text messages from us.

When you start verification, we send a 6-digit verification code by SMS text message to the phone number that's currently on file for the account. You don't enter a phone number to start verification. To finish, you enter the code before it expires.

Keep the following in mind when you verify a phone number:

  • In the China Regions, you can verify only a mainland China mobile phone number (+86). If the phone number on file is a landline or a number outside mainland China, you can't verify it. Update the phone number, and then start verification. For instructions, see Update the primary contact for a standalone Amazon Web Services account or management account.

  • The code expires 5 minutes after we send it.

  • If you request a new code, codes that we sent earlier no longer work.

  • If the code is incorrect or has expired, request a new code and try again.

  • If the phone number changes after we send a code, you can't use that code. Request a new code for the current number.

  • The verification status always describes the phone number that's currently on file. If you change the phone number, the status describes the new number.

  • For a member account in an organization, the code goes to the member account's primary contact phone number, not to yours. Before you start, make sure that you can get the code from whoever has that phone.

To check the verification status, use the GetContactInformation operation. The VerificationStatus field in the response has one of the following values:

  • VERIFIED – The phone number on file is verified.

  • UNVERIFIED – The phone number on file isn't verified.

  • NOT_SUPPORTED – Phone number verification isn't available for this account.

Verify the phone number for a standalone or management Amazon Web Services account

To verify the phone number of the account whose credentials you use, use the following Amazon CLI commands or their Amazon SDK equivalent operations:

Minimum permissions

For each operation, you must have the permission that maps to that operation:

  • account:SendPhoneNumberVerification

  • account:VerifyPhoneNumber

To check the verification status, you also need account:GetContactInformation.

Example

The following Amazon CLI example sends a verification code to the primary contact phone number of the caller's account:

$ aws account send-phone-number-verification { "Status": "PENDING" }
Example

The following Amazon CLI example submits the code to finish verification:

$ aws account verify-phone-number --otp 123456 { "Status": "VERIFIED" }
Example

The following Amazon CLI example retrieves the verification status of the caller's primary contact phone number:

$ aws account get-contact-information --query VerificationStatus "VERIFIED"

Verify the phone number for a member account in your organization

You can verify the phone number of a member account by using the Amazon Organizations console, the Amazon CLI, or an Amazon SDK. Before you start, complete the steps in Additional requirements.

Amazon Web Services Management Console
To verify the primary contact phone number for a member account
Minimum permissions

To perform the following steps, you must have at least the following IAM permissions:

  • account:GetContactInformation (to see the phone number and whether it's verified)

  • account:SendPhoneNumberVerification (to send a verification code)

  • account:VerifyPhoneNumber (to submit the code)

The AWSOrganizationsFullAccess managed policy doesn't include account:SendPhoneNumberVerification or account:VerifyPhoneNumber. If you rely on that policy, grant these permissions separately.

  1. Sign in to the Amazon Organizations console with the organization's management account credentials.

  2. From Amazon Web Services accounts, select the member account.

  3. Choose Contact info, and locate Primary contact.

  4. If the phone number isn't verified, it appears with a warning. Choose the phone number, and then choose Verify phone number. We send a 6-digit code to the member account's phone number.

  5. Enter the code in Verification code, and then choose Verify.

    If the code doesn't arrive, choose Resend code when that option becomes available.

Amazon CLI & SDKs

To verify a member account's phone number, use the following Amazon CLI commands or their Amazon SDK equivalent operations, and specify the member account ID:

Notes
  • The credentials that you use must be from either the organization's management account or the delegated admin account for Amazon Account Management.

  • You can't access an account in a different organization from the one you are using to call the operation.

Minimum permissions

For each operation, you must have the permission that maps to that operation:

  • account:SendPhoneNumberVerification

  • account:VerifyPhoneNumber

To check the verification status, you also need account:GetContactInformation.

Example

The following Amazon CLI example sends a verification code to the primary contact phone number of the specified member account:

$ aws account send-phone-number-verification --account-id 123456789012 { "Status": "PENDING" }
Example

The following Amazon CLI example submits the code that we sent to the member account's phone number:

$ aws account verify-phone-number --account-id 123456789012 --otp 123456 { "Status": "VERIFIED" }