---
title: "POST /connector-destinations"
method: POST
path: "/connector-destinations"
---

# POST /connector-destinations

`POST /connector-destinations`

Create a connector destination for connecting a cloud-to-cloud (C2C) connector to the customer's Amazon Web Services account.

## Request body

- object
  - `Name` string — The display name of the connector destination.
  - `Description` string — A description of the connector destination.
  - `CloudConnectorId` string, required — The identifier of the C2C connector.
  - `AuthType` 'OAUTH' — The authentication type used for the connector destination, which determines how credentials and access are managed.
  - `AuthConfig` object, required — The authentication configuration details for a connector destination, including OAuth settings and other authentication parameters.
    - `oAuth` object — The OAuth configuration settings used for authentication with the third-party service.
      - `authUrl` string, required — The authorization URL for the OAuth service, where users are directed to authenticate and authorize access.
      - `tokenUrl` string, required — The token URL for the OAuth service, where authorization codes are exchanged for access tokens.
      - `scope` string — The OAuth scopes requested during authorization, which define the permissions granted to the application.
      - `tokenEndpointAuthenticationScheme` 'HTTP_BASIC' | 'REQUEST_BODY_CREDENTIALS', required — The authentication scheme used when requesting tokens from the token endpoint.
      - `oAuthCompleteRedirectUrl` string — The URL where users are redirected after completing the OAuth authorization process.
      - `proactiveRefreshTokenRenewal` object — Configuration for proactively refreshing OAuth tokens before they expire.
        - `enabled` boolean — Indicates whether proactive refresh token renewal is enabled.
        - `DaysBeforeRenewal` integer — The days before token expiration when the system should attempt to renew the token, specified in days.
    - `GeneralAuthorization` AuthMaterial[] — The authorization materials for General Authorization.
      - `SecretsManager` SecretsManager, required — Configuration for AWS Secrets Manager, used to securely store and manage sensitive information for connector destinations.
        - `arn` string, required — The Amazon Resource Name (ARN) of the AWS Secrets Manager secret.
        - `versionId` string, required — The version ID of the AWS Secrets Manager secret.
      - `AuthMaterialName` string, required — The name of the authorization material.
  - `SecretsManager` object — Configuration for AWS Secrets Manager, used to securely store and manage sensitive information for connector destinations.
    - `arn` string — The Amazon Resource Name (ARN) of the AWS Secrets Manager secret.
    - `versionId` string — The version ID of the AWS Secrets Manager secret.
  - `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.

## Response `201`

Success

- CreateConnectorDestinationResponse
  - `Id` string — The identifier of the C2C connector destination creation request.

## Other responses

- `480` — AccessDeniedException
- `481` — ValidationException
- `482` — InternalServerException
- `483` — UnauthorizedException
- `484` — ConflictException
- `485` — ThrottlingException
- `486` — 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)