---
title: "Add an AWS Account to the Redbox account pool"
method: POST
path: "/accounts"
---

# Add an AWS Account to the Redbox account pool

`POST /accounts`

## Request body

- object
  - `id` string, required — AWS Account ID
  - `adminRoleArn` string, required — ARN for an IAM role within this AWS account. The Redbox master account will assume this IAM role to execute operations within this AWS account. This IAM role is configured by the client, and must be configured with [a Trust Relationship with the Redbox master account.](/https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_cross-account-with-roles.html)

## Other responses

- `201` — unresolved $ref
- `403` — Failed to authenticate request

---

[API](https://skmtc.dev/optum/apis/namespace.md) · [All operations](https://skmtc.dev/optum/apis/namespace/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/optum/namespace/revisions/eed5055f8eb6/schema)