v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1483477323.4 KB

Creates a new account association via the destination id.

post/account-associations

Request body

ClientTokenstring

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.

ConnectorDestinationIdstring required

The identifier of the connector destination.

Namestring

The name of the destination for the new account association.

Descriptionstring

A description of the account association request.

Tagsobject

A set of key/value pairs that are used to manage the account association.

Response

Success

OAuthAuthorizationUrlstring 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.

AccountAssociationIdstring 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.

Arnstring

The Amazon Resource Name (ARN) of the account association.