# Create subscription

Creates a new subscription with specified configuration

Endpoint: POST /subscriptions/create
Version: 2.0.0
Security: oauth2ClientCredentials

## Header parameters:

  - `org_wallet_ref` (string)
    Organization wallet reference, defaults to "1" if not provided

  - `business_id` (string, required)
    Business identifier for the request

## Request fields (application/json):

  - `name` (string, required)
    Merchant/subscription name
    Example: DIGITALOCEAN.COM

  - `limit` (object, required)
    Spending limit
    Example: 10

  - `cards` (array, required)
    Array of card IDs
    Example: ["683ee0b950009c749ba23312"]

  - `assignee` (string, required)
    Employee ID to assign the subscription to
    Example: 67befe9f17f57a814696e291

  - `status` (string, required)
    Subscription status
    Example: DRAFT

  - `frequency_period_unit` (string, required)
    Frequency period unit (MONTH, YEAR, etc.)
    Example: MONTH

  - `wallet_name` (string, required)
    Wallet display name
    Example: xyz - MAIN

  - `wallet_currency` (string, required)
    Wallet currency code
    Example: KES

  - `wallet_id` (string, required)
    Wallet identifier
    Example: 1271

  - `web_url` (string)
    Merchant website URL
    Example: https://www.digitalocean.com

  - `create_new_merchant` (boolean)
    Flag to create new merchant
    Example: false

  - `team` (object, required)
    Team assignment

  - `team._id` (string, required)
    Team ID
    Example: 688877881b49af84b1aa11d9

  - `team.code` (string, required)
    Team code
    Example: 74CAAEEA

  - `team.name` (string, required)
    Team name
    Example: AAR Bamburi

  - `subcategory` (object, required)
    Expense category

  - `subcategory._id` (string, required)
    Subcategory ID
    Example: 64f04ea40aac0abfb44b3bb7

  - `subcategory.code` (string, required)
    Subcategory code
    Example: P003

  - `subcategory.name` (string, required)
    Subcategory name
    Example: General Materials

  - `is_request` (boolean)
    Flag indicating if this is a request
    Example: false

  - `org_wallet_ref` (number, required)
    Organization wallet reference
    Example: 1

  - `business_id` (string, required)
    Organization business ID
    Example: E74490ACDCAF716DC722

  - `notes` (string)
    Additional notes
    Example: Brian Ryb is requesting creation of a DIGITALOCEAN.COM subscription

## Response 201 fields (application/json):

  - `_id` (string)
    Subscription ID

  - `business` (object)
    Business information

  - `business._id` (string)
    Business ID

  - `business.name` (string)
    Business name

  - `business.email` (string)
    Business email

  - `business.phone` (string)
    Business phone

  - `business.country` (string)
    Business country

  - `name` (string)
    Subscription name

  - `limit` (number)
    Subscription limit

  - `cards` (array)
    Associated cards

  - `cards._id` (string)
    Card ID

  - `cards.exp_month` (string)
    Card expiration month

  - `cards.exp_year` (string)
    Card expiration year

  - `cards.brand` (string)
    Card brand

  - `cards.last4` (string)
    Last 4 digits of card

  - `cards.bin` (string)
    Card BIN

  - `cards.blocked` (boolean)
    Card blocked status

  - `cards.retired` (boolean)
    Card retired status

  - `cards.issued_on` (string)
    Card issued date

  - `cards.provider` (string)
    Card provider

  - `cards.currency` (string)
    Card currency

  - `cards.tracking_number` (string)
    Card tracking number

  - `cards.is_virtual` (boolean)
    Is virtual card

  - `cards.is_offline` (boolean)
    Is offline card

  - `cards.dormant` (boolean)
    Card dormant status

  - `cards.purged` (boolean)
    Card purged status

  - `assignee` (object)
    Subscription assignee

  - `assignee._id` (string)
    Assignee ID

  - `assignee.name` (string)
    Assignee name

  - `assignee.employee_id` (string)
    Employee ID

  - `assignee.team_code` (string)
    Team code

  - `status` (string)
    Subscription status
    Enum: "DRAFT", "ACTIVE", "PAUSED", "REJECTED", "DELETED", "PENDING"

  - `wallet_id` (string)
    Wallet ID

  - `wallet_currency` (string)
    Wallet currency

  - `frequency_period_unit` (string)
    Frequency period unit

  - `frequency` (number)
    Frequency

  - `icon` (string)
    Subscription icon URL

  - `merchant_category_code` (string)
    Merchant category code

  - `merchant_receiver_name` (string)
    Merchant receiver name

  - `amount_spent` (number)
    Amount spent

  - `last_transacted_amount` (number)
    Last transacted amount

  - `score` (number)
    Score

  - `next_invoice_date` (string)
    Next invoice date

  - `createdAt` (string)
    Created date

  - `updatedAt` (string)
    Updated date

  - `subcategory` (object)
    Subcategory information

  - `subcategory._id` (string)
    Subcategory ID

  - `subcategory.code` (string)
    Subcategory Code

  - `subcategory.name` (string)
    Subcategory Name

  - `team` (object)
    Subcategory information

  - `team.code` (string)
    Team Code

  - `team.name` (string)
    Team Name