Method

Search:

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 AWS accounts only from the same seller as the master account. For example,
if your organization's master account was created by Amazon Internet Services Pvt.
Ltd (AISPL), an AWS seller in India, then you can only invite other AISPL accounts
to your organization. You can't combine accounts from AISPL and AWS, or any other
AWS 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, then contact
AWS Customer Support.

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

Note:

For .NET Core and PCL this operation is only available in asynchronous form. Please refer to InviteAccountToOrganizationAsync.

Exceptions

You don't have permissions to perform the requested operation. The user or role that
is making the request must have at least one IAM permissions policy attached that
grants the required permissions. For more information, see Access
Management in the IAM User Guide.

A handshake with the same action and target already exists. For example, if you invited
an account to join your organization, the invited account might already have a pending
invitation from this organization. If you intend to resend an invitation to an account,
ensure that existing handshakes that might be considered duplicates are canceled or
declined.

AWS Organizations could not perform the operation because your organization has not
finished initializing. This can take up to an hour. Try again later. If after one
hour you continue to receive this error, contact
AWS Customer Support.

The requested operation would violate the constraint identified in the reason code.
Some of the reasons in the following list might not be applicable to this specific
API or operation:
ACCOUNT_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the limit on the number of
accounts in an organization. Note: deleted and closed accounts still count
toward your limit.
If you get this exception immediately after creating the organization, wait one hour
and try again. If after an hour it continues to fail with this error, contact AWS
Customer Support.
HANDSHAKE_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of handshakes you
can send in one day.
ALREADY_IN_AN_ORGANIZATION: The handshake request is invalid because the invited account
is already a member of an organization.
ORGANIZATION_ALREADY_HAS_ALL_FEATURES: The handshake request is invalid because the
organization has already enabled all features.
INVITE_DISABLED_DURING_ENABLE_ALL_FEATURES: You cannot issue new invitations to join
an organization while it is in the process of enabling all features. You can resume
inviting accounts after you finalize the process when all accounts have agreed to
the change.
PAYMENT_INSTRUMENT_REQUIRED: You cannot complete the operation with an account that
does not have a payment instrument, such as a credit card, associated with it.
ORGANIZATION_FROM_DIFFERENT_SELLER_OF_RECORD: The request failed because the account
is from a different marketplace than the accounts in the organization. For example,
accounts with India addresses must be associated with the AISPL marketplace. All accounts
in an organization must be from the same marketplace.
ORGANIZATION_MEMBERSHIP_CHANGE_RATE_LIMIT_EXCEEDED: You attempted to change the membership
of an account too quickly after its previous change.

The requested operation failed because you provided invalid values for one or more
of the request parameters. This exception includes a reason that contains additional
information about the violated limit:
Some of the reasons in the following list might not be applicable to this specific
API or operation:
IMMUTABLE_POLICY: You specified a policy that is managed by AWS and cannot be modified.
INPUT_REQUIRED: You must include a value for all required parameters.
INVALID_ENUM: You specified a value that is not valid for that parameter.
INVALID_FULL_NAME_TARGET: You specified a full name that contains invalid characters.
INVALID_LIST_MEMBER: You provided a list to a parameter that contains at least one
invalid value.
INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, organization,
or email) as a party.
INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter from the response
to a previous call of the operation.
INVALID_PATTERN: You provided a value that doesn't match the required pattern.
INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't match the
required pattern.
INVALID_ROLE_NAME: You provided a role name that is not valid. A role name can’t begin
with the reserved prefix 'AWSServiceRoleFor'.
INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the organization.
INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID.
MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter for the operation.
MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer than allowed.
MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger value than
allowed.
MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter than allowed.
MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller value than
allowed.
MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only between entities
in the same root.