Skip to main content

Update AWS Account Contact Details

You can update the primary and alternate account contact details for your Stax-managed AWS accounts from the AWS Organization's management account.

note

These steps apply only to Stax tenancies with a customer-owned management account. For organizations with a reseller-owned management account, you must raise a support case to have this task completed.

Before You Begin​

  • Determine the management account for your AWS Organization (it will be the only account in the foundation-managementAccount Type)

  • Determine which AWS accounts you wish to update the contact details for, and record their AWS account IDs

  • Determine the new contact details

Update Primary Contact Details​

  1. Gain CLI access to your AWS Organization's management account using stax2aws or AWS CloudShell. You should use an access level such as the built-in admin role that has the appropriate privileges to issue the commands below

  2. Issue the get-contact-information command to retrieve the current contact information for the target account.

    aws account get-contact-information --account-id 123456789012 --query 'ContactInformation' --output json

The command will return a JSON-formatted response object 3. Update the JSON object to contain the new contact details. If the desired fields are not present, review the API documentation for a list of supported fields and adjust the object accordingly 4. Issue the put-contact-information command with the updated JSON object to update the contact information for the account:

aws account put-contact-information --account-id 123456789012 --contact-information '<json-contact-info>'

Replace <json-contact-info> above with the JSON object from the previous step. The command will not return any response if it is successful 5. Re-run the get-contact-information command to confirm that the details were set correctly

Repeat this process for all accounts that need their contact details updated.

Update Alternative Contact Details​

  1. Gain CLI access to your AWS Organization's management account using stax2aws or AWS CloudShell. You should use an access level such as the built-in admin role that has the appropriate privileges to issue the commands below

  2. Issue the get-alternate-contact command to retrieve the current contact information for the target account. Choose the appropriate alternate contact type from the possible values:BILLING, OPERATIONS, and SECURITY

    aws account get-alternate-contact --account-id 123456789012 --output json

The command will return a JSON-formatted response object 3. Issue the following command to generate a JSON object for the new contact's details:

aws account put-alternate-contact --generate-cli-skeleton
{
  "AccountId": "",
  "AlternateContactType": "OPERATIONS",
  "EmailAddress": "",
  "Name": "",
  "PhoneNumber": "",
  "Title": ""
}

Update the object to have the appropriate details. Ensure the AlternateContactType value is set appropriately 4. Issue the put-alternate-contact command with the updated JSON object to update the alternate contact information for the account:

aws account put-alternate-contact --cli-input-json '<json-contact-info>'

Replace <json-contact-info> above with the JSON object from the previous step. The command will not return any response if it is successful 5. Re-run the get-alternate-contact command to confirm that the details were set correctly

Repeat this process for all accounts that need their contact details updated.