---
title: "POST /account-associations"
method: POST
path: "/account-associations"
---

# POST /account-associations

`POST /account-associations`

Creates a new account association via the destination id.

## Request body

- object
  - `ClientToken` string — An idempotency token. If you retry a request that completed successfully initially using the same client token and parameters, then the retry attempt will succeed without performing any further actions.
  - `ConnectorDestinationId` string, required — The identifier of the connector destination.
  - `Name` string — The name of the destination for the new account association.
  - `Description` string — A description of the account association request.
  - `Tags` object — A set of key/value pairs that are used to manage the account association.
  - `GeneralAuthorization` object — The General Authorization reference by authorization material name.
    - `AuthMaterialName` string — The name of the authorization material.

## Response `201`

Success

- CreateAccountAssociationResponse
  - `OAuthAuthorizationUrl` string, password, required — Third-party IoT platform OAuth authorization server URL backed with all the required parameters to perform end-user authentication. This field will be empty when using General Authorization flows that do not require OAuth.
  - `AccountAssociationId` string, required — The identifier for the account association request.
  - `AssociationState` 'ASSOCIATION_IN_PROGRESS' | 'ASSOCIATION_FAILED' | 'ASSOCIATION_SUCCEEDED' | 'ASSOCIATION_DELETING' | 'REFRESH_TOKEN_EXPIRED', required — The current state of the account association request.
  - `Arn` string — The Amazon Resource Name (ARN) of the account association.

## Other responses

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

---

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