Update the primary contact for your AWS account
These instructions are for how to update the primary contact for your AWS account if you signed up for AWS using Sign up for AWS (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 AWS accounts – For AWS accounts not associated with an organization, you can update your own primary account contact using the AWS Management Console, or via AWS CLI & SDKs. To learn how to do this, see Update standalone AWS account primary contact.
-
AWS accounts within an organization – For member accounts that are part of an AWS organization, a user in the management account or delegated admin account can centrally update any member account in the organization from the AWS Organizations console, or programmatically via the AWS CLI & SDKs. To learn how to do this, see Update AWS account primary contact in your organization.
Topics
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 AWS. Toll free numbers will not be accepted since most don't support SMS.
-
For business AWS 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 AWS account or management account
To edit your primary contact details for a standalone AWS account or a management account, perform the steps in the following procedure. The following AWS Management Console procedure always works only in the standalone context. You can use the AWS Management Console to access or change only the primary contact information of the account you used to call the operation.
Update the primary contact for any AWS member account in your organization
To edit your primary contact details in any AWS member account in your organization, perform the steps in the following procedure.
Additional requirements
To update primary contact with the AWS 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 AWS Account Management service. To set this up, see Enable trusted access for AWS Account Management.
Verify the primary contact phone number
You can verify the phone number in the primary contact information for an AWS 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:
-
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 AWS account
To verify the phone number of the account whose credentials you use, use the following AWS CLI commands or their AWS 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 AWS 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 AWS CLI example submits the code to finish verification:
$aws account verify-phone-number --otp 123456{ "Status": "VERIFIED" }
Example
The following AWS 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 AWS Organizations console, the AWS CLI, or an AWS SDK. Before you start, complete the steps in Additional requirements.
