<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "AdvancedCommerceAPI",
  "identifier" : "/documentation/AdvancedCommerceAPI/SubscriptionCreateRequest",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Advanced Commerce API"
    ],
    "preciseIdentifier" : "data:advanced-commerce-api:SubscriptionCreateRequest"
  },
  "title" : "SubscriptionCreateRequest"
}
-->

# SubscriptionCreateRequest

The request data your app provides when a customer purchases an auto-renewable subscription.

```
object SubscriptionCreateRequest
```

## Overview

### Example: subscription with a single item

**Request:**

```json
{
    "operation": "CREATE_SUBSCRIPTION",
    "version": "1", 
    "requestInfo": {
        "requestReferenceId": "74ad2401-488d-4e1a-9c9d-80cdf0efed67"
    },
    "currency": "USD", 
    "taxCode": "C003-00-1", 
    "descriptors": {
        "displayName": "Anne's Game Stream",
        "description": "Streaming Service for Anne's Game"
    },
    "period": "P1M",
    "storefront": "USA",
    "items": [ 
        {
            "SKU": "ANNES_GOLD_TIER_1M",
            "displayName": "Gold Tier",                        
            "description": "Access to Anne's Game Stream",
            "price": 7990
        }
    ]
}
```

### Example: subscription with multiple items and an offer

**Request:**

```json
{
    "operation": "CREATE_SUBSCRIPTION",
    "version": "1", 
    "requestInfo": {
        "requestReferenceId": "74ad2401-488d-4e1a-9c9d-80cdf0efed67"
    },
    "currency": "USD", 
    "taxCode": "C003-00-1", 
    "descriptors": {
        "displayName": "Streaming Pass",
        "description": "Streaming pass with multiple items"
    },
    "period": "P1M",
    "storefront": "USA",
    "items": [ 
        {
            "SKU": "LIVE_SPORTS",
            "displayName": "Live Sports",                        
            "description": "Streaming for sports events",
            "price": 40000
        },
        {
            "SKU": "SATURDAY_MORNING_CARTOONS",
            "displayName": "Saturday Morning Cartoons",
            "description": "Streaming for animated series",
            "price": 11000,
            "offer": {
                "price": 2990, 
                "period": "P1M",
                "periodCount": 3,
                "reason": "ACQUISITION"
            }
        }
    ]
}
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)