inviteAccountToOrganization

Sends an invitation to another account to join your organization as a member account. Organizations sends email on your behalf to the email address that is associated with the other account's owner. The invitation is implemented as a Handshake whose details are in the response.

• You can invite Amazon Web Services accounts only from the same seller as the management account. For example, if your organization's management account was created by Amazon Internet Services Pvt. Ltd (AISPL), an Amazon Web Services seller in India, you can invite only other AISPL accounts to your organization. You can't combine accounts from AISPL and Amazon Web Services or from any other Amazon Web Services seller. For more information, see Consolidated billing in India.

• If you receive an exception that indicates that you exceeded your account limits for the organization or that the operation failed because your organization is still initializing, wait one hour and then try again. If the error persists after an hour, contact Amazon Web Services Support. If the request includes tags, then the requester must have the organizations:TagResource permission.

This operation can be called only from the organization's management account.

Samples

fun main() { 
   //sampleStart 
   // The following example shows the admin of the master account owned by bill example. com inviting the
// account owned by juan example. com to join an organization.
val resp = organizationsClient.inviteAccountToOrganization {
    notes = "This is a request for Juan's account to join Bill's organization"
    target = HandshakeParty {
        type = HandshakePartyType.fromValue("EMAIL")
        id = "juan@example.com"
    }
} 
   //sampleEnd
}