---
title: "Create a co-term group"
method: POST
path: "/subscriptions/coterm"
tags: ["Subscriptions"]
---

# Create a co-term group

`POST /subscriptions/coterm`

Creates a new co-term group for eligible subscriptions under the same account.

## Request body

- CreateCoTermGroupRequest — Request body to create a new co-term group.
  - `accountId` string, required — The ID of the account the subscriptions belong to.
  - `coTermGroup` object, required — Container for the group details.
    - `displayName` string — A human-readable name for the group.
    - `subscriptions` string[] — List of Subscription IDs to include in the group.

## Response `200`

OK

- CoTermCreateResponse — Response returned upon successful creation of a group.
  - `action` string — The action performed.
  - `result` string — The result of the operation.
  - `accountId` string — Account ID associated with the group.
  - `coTermGroup` CoTermGroupObject — Nested object representing the group data in a Create response.
    - `coTermGroupId` string — Unique identifier for the co-term group.
    - `displayName` string — Display name of the group.
    - `groupingCriteria` GroupingCriteria[] — List of criteria used to validate the group.
      - `interval` object[] — Allowed billing intervals.
        - `unit` string — The interval unit.
        - `length` integer — The interval length.
      - `currency` string[] — Allowed currencies.
      - `paymentMethods` object[] — Allowed payment methods.
        - `type` string — Payment method type.
        - `ending` string — Display string for the payment method.
    - `subscriptions` object[] — List of subscriptions in the group.
      - `subscription` string — The subscription ID.
      - `status` string — The status of the subscription within the group.

---

[API](https://skmtc.net/fastspring/apis/fastspring-api-accounts.md) · [All operations](https://skmtc.net/fastspring/apis/fastspring-api-accounts/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fastspring/fastspring-api-accounts/versions/ae2f0b97db3e/schema)