---
title: "POST /v2/domains/{domainIdentifier}/environments/{environmentIdentifier}/subscription-targets"
method: POST
path: "/v2/domains/{domainIdentifier}/environments/{environmentIdentifier}/subscription-targets"
---

# POST /v2/domains/{domainIdentifier}/environments/{environmentIdentifier}/subscription-targets

`POST /v2/domains/{domainIdentifier}/environments/{environmentIdentifier}/subscription-targets`

Creates a subscription target in Amazon DataZone.

## Path parameters

- `domainIdentifier` string, required
- `environmentIdentifier` string, required

## Request body

- object
  - `name` string, password, required — The name of the subscription target.
  - `type` string, required — The type of the subscription target.
  - `subscriptionTargetConfig` SubscriptionTargetForm[], required — The configuration of the subscription target.
    - `formName` string, required — The form name included in the subscription target configuration.
    - `content` string, required — The content of the subscription target configuration.
  - `authorizedPrincipals` AuthorizedPrincipalIdentifier[], required — The authorized principals of the subscription target.
  - `manageAccessRole` string, required — The manage access role that is used to create the subscription target.
  - `applicableAssetTypes` TypeName[], required — The asset types that can be included in the subscription target.
  - `provider` string — The provider of the subscription target.
  - `clientToken` string — A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
  - `subscriptionGrantCreationMode` 'AUTOMATIC' | 'MANUAL' — Determines the subscription grant creation mode for this target, defining if grants are auto-created upon subscription approval or managed manually.

## Response `200`

Success

- CreateSubscriptionTargetOutput
  - `id` string, required — The ID of the subscription target.
  - `authorizedPrincipals` AuthorizedPrincipalIdentifier[], required — The authorised principals of the subscription target.
  - `domainId` string, required — The ID of the Amazon DataZone domain in which the subscription target was created.
  - `projectId` string, required — ???
  - `environmentId` string, required — The ID of the environment in which the subscription target was created.
  - `name` string, password, required — The name of the subscription target.
  - `type` string, required — The type of the subscription target.
  - `createdBy` string, required — The Amazon DataZone user who created the subscription target.
  - `updatedBy` string — The Amazon DataZone user who updated the subscription target.
  - `createdAt` string, date-time, required — The timestamp of when the subscription target was created.
  - `updatedAt` string, date-time — The timestamp of when the subscription target was updated.
  - `manageAccessRole` string — The manage access role with which the subscription target was created.
  - `applicableAssetTypes` TypeName[], required — The asset types that can be included in the subscription target.
  - `subscriptionTargetConfig` SubscriptionTargetForm[], required — The configuration of the subscription target.
    - `formName` string, required — The form name included in the subscription target configuration.
    - `content` string, required — The content of the subscription target configuration.
  - `provider` string, required — The provider of the subscription target.
  - `subscriptionGrantCreationMode` 'AUTOMATIC' | 'MANUAL' — Determines the subscription grant creation mode for this target, defining if grants are auto-created upon subscription approval or managed manually.

## Other responses

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

---

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