---
title: "POST /subscriptions/requests"
method: POST
path: "/subscriptions/requests"
tags: ["Subscriptions"]
---

# POST /subscriptions/requests

`POST /subscriptions/requests`

## Request body

- SubscriptionsNewBillingRequest
  - `asset_id` string, nullable
  - `asset_external_uid` string, nullable
  - `type` 'vendor' | 'provider'
  - `items` object[], required
  - `attributes` SubscriptionsAttribute
    - `vendor` object
    - `provider` object
  - `period_from` string, date-time, required
  - `period_to` string, date-time, required
  - `period_delta` number, required
  - `period_uom` 'monthly' | 'yearly' | 'years_2' | 'years_3' | 'years_4' | 'years_5' | 'years_6', required

## Response `201`

- SubscriptionsBillingRequest
  - `id` string
  - `type` 'vendor' | 'provider'
  - `events` object
    - `created` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `updated` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
  - `asset` SubscriptionsSubscriptionReference
    - `id` string
    - `status` 'draft' | 'processing' | 'active' | 'terminating' | 'suspended' | 'terminated'
    - `events` object
      - `created` object
        - `at` string, datetime
        - `by` object
          - `id` string
          - `name` string
          - `icon` string
      - `updated` object
        - `at` string, datetime
        - `by` object
          - `id` string
          - `name` string
          - `icon` string
    - `external_id` string, nullable
    - `external_uid` string, nullable
    - `product` SubscriptionsProduct
      - `id` string
      - `name` string, required
      - `status` string, required
      - `icon` string
      - `preferred_names` string
    - `connection` SubscriptionsConnection — Connection Serializer that handle syndication asset representation In scope of vendor as provider returns Hyper Provider instance from syndicated data Require 'asset' to be passed in context
      - `id` string
      - `type` 'test' | 'production' | 'preview', nullable
      - `provider` SubscriptionsAccount
        - `id` string
        - `name` string, required
        - `icon` string, nullable
      - `vendor` SubscriptionsAccount
        - `id` string
        - `name` string, required
        - `icon` string, nullable
      - `hub` SubscriptionsHub
        - `id` string
        - `name` string, required
    - `params` SubscriptionsParameter[]
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `type` string, required
      - `value` string, nullable
      - `value_error` string, nullable
      - `structured_value` object, nullable
    - `tiers` object
      - `customer` SubscriptionsTierAccount
        - `id` string
        - `external_id` string, nullable
        - `external_uid` string, nullable
        - `name` string
        - `tax_id` string, nullable
        - `contact_info` object
          - `address_line1` string, required
          - `address_line2` string
          - `city` string, required
          - `state` string
          - `postal_code` string, required
          - `country` string, required
          - `contact` object, required
            - `first_name` string, required
            - `last_name` string, required
            - `email` string, email, required
            - `phone_number` object, required
              - …
      - `tier1` SubscriptionsTierAccount
        - `id` string
        - `external_id` string, nullable
        - `external_uid` string, nullable
        - `name` string
        - `tax_id` string, nullable
        - `contact_info` object
          - `address_line1` string, required
          - `address_line2` string
          - `city` string, required
          - `state` string
          - `postal_code` string, required
          - `country` string, required
          - `contact` object, required
            - `first_name` string, required
            - `last_name` string, required
            - `email` string, email, required
            - `phone_number` object, required
              - …
      - `tier2` SubscriptionsTierAccount
        - `id` string
        - `external_id` string, nullable
        - `external_uid` string, nullable
        - `name` string
        - `tax_id` string, nullable
        - `contact_info` object
          - `address_line1` string, required
          - `address_line2` string
          - `city` string, required
          - `state` string
          - `postal_code` string, required
          - `country` string, required
          - `contact` object, required
            - `first_name` string, required
            - `last_name` string, required
            - `email` string, email, required
            - `phone_number` object, required
              - …
    - `marketplace` SubscriptionsMarketplace
      - `id` string
      - `name` string, required
      - `icon` string, nullable
    - `contract` SubscriptionsContract
      - `id` string
      - `name` string, required
    - `billing` object
      - `period` object
        - `delta` number
        - `uom` 'monthly' | 'yearly' | 'years_2' | 'years_3' | 'years_4' | 'years_5' | 'years_6'
      - `next_date` string, date-time
      - `anniversary` object
        - `day` integer
        - `month` integer
    - `renewal_expiration_date` string, date-time, nullable
  - `items` SubscriptionsItemRequestReference[]
    - `id` string, required
    - `global_id` string, required
    - `display_name` string, required
    - `mpn` string, required
    - `item_type` string, required
    - `period` string, required
    - `quantity` number
    - `type` string, required
    - `billing` object
      - `cycle_number` integer
  - `attributes` SubscriptionsAttribute[]
    - `vendor` object
    - `provider` object
  - `period` object
    - `from` string, date-time
    - `to` string, date-time
    - `delta` number
    - `uom` 'monthly' | 'yearly' | 'years_2' | 'years_3' | 'years_4' | 'years_5' | 'years_6'

## Other responses

- `400`

---

[API](https://skmtc.net/cloudblue/apis/cloudblue-connect-api.md) · [All operations](https://skmtc.net/cloudblue/apis/cloudblue-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudblue/cloudblue-connect-api/revisions/0421d2a97c52/schema)