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

# Add an AWS Account to the 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 DCE 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 DCE master account.](/https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_cross-account-with-roles.html)
  - `metadata` object — Arbitrary metadata to attach to the account object.

## 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/11d73002ea62/schema)