---
title: "POST /applications/{applicationId}/subscriptions"
method: POST
path: "/applications/{applicationId}/subscriptions"
---

# POST /applications/{applicationId}/subscriptions

`POST /applications/{applicationId}/subscriptions`

Subscribes an IAM Identity Center user or a group to a pricing tier for an Amazon Q Business application.

Amazon Q Business offers two subscription tiers: `Q_LITE` and `Q_BUSINESS`. Subscription tier determines feature access for the user. For more information on subscriptions and pricing tiers, see [Amazon Q Business pricing](https://aws.amazon.com/q/business/pricing/).

For an example IAM role policy for assigning subscriptions, see [Set up required permissions](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/setting-up.html#permissions) in the Amazon Q Business User Guide.

## Path parameters

- `applicationId` string, required

## Request body

- object
  - `principal` object, required — A user or group in the IAM Identity Center instance connected to the Amazon Q Business application.
    - `user` string — The identifier of a user in the IAM Identity Center instance connected to the Amazon Q Business application.
    - `group` string — The identifier of a group in the IAM Identity Center instance connected to the Amazon Q Business application.
  - `type` 'Q_LITE' | 'Q_BUSINESS', required — The type of Amazon Q Business subscription you want to create.
  - `clientToken` string — A token that you provide to identify the request to create a subscription for your Amazon Q Business application.

## Response `200`

Success

- CreateSubscriptionResponse
  - `subscriptionId` string — The identifier of the Amazon Q Business subscription created.
  - `subscriptionArn` string — The Amazon Resource Name (ARN) of the Amazon Q Business subscription created.
  - `currentSubscription` object — The type of your current Amazon Q Business subscription.
    - `type` 'Q_LITE' | 'Q_BUSINESS' — The type of an Amazon Q Business subscription.
  - `nextSubscription` object — The type of the Amazon Q Business subscription for the next month.
    - `type` 'Q_LITE' | 'Q_BUSINESS' — The type of an Amazon Q Business subscription.

## Other responses

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

---

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