Skip to navigation
REST RPC APISubscriptions

Create in Order

View as Markdown

Creates a subscription with its first shipment in an existing order (dictated by the ‘order’ field in the request). This will be tracked by OrderGroove as an ‘Impulse Upsell’ order.

Authentication

x-api-keystring

Application API Scope — server-to-server, sent in the x-api-key header. See Authentication.

OR
authorizationstring

Storefront API Scope — client-side, scoped to one customer, sent as a signature in the authorization header. See Authentication.

Request

This endpoint expects an object.
merchantstringRequired
Merchant ID
customerstringRequired
Customer ID
productstringRequired
Product ID
offerstringRequired
Offer ID
orderstringRequired
Order ID
session_idstringRequired

Session ID, obtained from og_session_id cookie

paymentstringRequired
Payment record ID
shipping_addressstringRequired
Shipping address record ID
quantityintegerRequired
Number of items
everyintegerRequired
Number of periods
every_periodintegerRequired
Type of period
pricestringOptional
Price of subscription. To be used with Price Lock.
extra_datastringOptionalformat: "json"

{“cat_name”: “Charlie”}

componentslist of objectsOptional

Multi Item Bundle components: [{“product”:“public_id_abc”, “quantity”: 2}], Legacy Bundle components: [{“product”:“public_id_abc”}]

Response

201
customerstringOptional
merchantstringOptional
productstringOptional
paymentstringOptional
shipping_addressstring or nullOptional
offerstring or nullOptional
offer_profile_public_idstring or nullOptional
Public ID of the offer profile the subscription's offer belongs to. Returned only by List and Retrieve.
subscription_typestringOptional
raw_subscription_typestringOptional

The subscription type as stored. subscription_type reports IU replenishment and CSA replenishment as replenishment; this field keeps the original value.

componentslist of objectsOptional

Bundle components. Each has product; public_id and quantity are returned only when the merchant has multi-item bundles enabled.

extra_dataobjectOptional

Custom data stored on the subscription, as a JSON object. {} when the subscription has none. Ordergroove and your integrations can store their own keys here.

public_idstringOptional
product_attributeinteger or nullOptional
quantityintegerOptional
pricestring or nullOptional
frequency_daysintegerOptional
reminder_daysintegerOptional
everyintegerOptional
every_periodintegerOptional
start_datestringOptional
cancelledstring or nullOptional
cancel_reasonstring or nullOptional
cancel_reason_codeinteger or nullOptional
iterationinteger or nullOptional
sequenceinteger or nullOptional
session_idstringOptional
merchant_order_idstring or nullOptional
customer_repinteger or nullOptional
clubinteger or nullOptional
createdstringOptional
updatedstringOptional
livebooleanOptional
external_idstring or nullOptional
currency_codestring or nullOptional

Three-letter ISO currency code.

queued_actionslist of objectsOptional

Pending queued actions, in order. Returned only when the merchant has queued actions enabled; empty when the subscription isn’t live or has none.

prepaid_subscription_contextobject or nullOptional

Prepaid details. Returned only when the merchant has prepaid subscriptions enabled; null when this subscription isn’t prepaid.

granteeslist of objectsOptional
List of grantees associated with the subscription. Omitted if the subscription has no grantees.
free_trial_subscription_contextobjectOptional

Present only if the subscription has a free trial context (i.e. it was created for a product with a free trial configured); omitted otherwise.

Errors

400
Bad Request Error
403
Forbidden Error