---
title: "POST /invitations"
method: POST
path: "/invitations"
---

# POST /invitations

`POST /invitations`

Sends an Amazon Macie membership invitation to one or more accounts.

## Request body

- object
  - `accountIds` String[], required — An array that lists Amazon Web Services account IDs, one for each account to send the invitation to.
  - `disableEmailNotification` boolean — Specifies whether to send the invitation as an email message. If this value is false, Amazon Macie sends the invitation (as an email message) to the email address that you specified for the recipient's account when you associated the account with your account. The default value is false.
  - `message` string — Custom text to include in the email message that contains the invitation. The text can contain as many as 80 alphanumeric characters.

## Response `200`

Success

- CreateInvitationsResponse
  - `unprocessedAccounts` UnprocessedAccount[] — An array of objects, one for each account whose invitation hasn't been processed. Each object identifies the account and explains why the invitation hasn't been processed for the account.
    - `accountId` string — The Amazon Web Services account ID for the account that the request applies to.
    - `errorCode` 'ClientError' | 'InternalError' — The source of the issue or delay in processing the request.
    - `errorMessage` string — The reason why the request hasn't been processed.

## Other responses

- `480` — ValidationException
- `481` — InternalServerException
- `482` — ServiceQuotaExceededException
- `483` — AccessDeniedException
- `484` — ResourceNotFoundException
- `485` — ThrottlingException
- `486` — ConflictException

---

[API](https://skmtc.net/aws/apis/macie2.md) · [All operations](https://skmtc.net/aws/apis/macie2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/macie2/versions/6252cf55d8ef/schema)