---
title: "Creates a subscription to the orders"
method: POST
path: "/v2/user/marketplaces/orders/subscriptions/{id}"
tags: ["Marketplaces - Orders - Subscriptions - Subscriptions"]
---

# Creates a subscription to the orders

`POST /v2/user/marketplaces/orders/subscriptions/{id}`

Please take a look at this sequence diagram to understand the subscription process to follow [here](https://www.websequencediagrams.com/files/render?link=SBYbeIc8NGshk6ooCbmjoBLIMl4fIGO1xjJbPBQAglBo0n6BwEReh7NXQiPSjOTX)

## Path parameters

- `id` string, SubscriptionId, required

## Request body

- CreateSubscriptionRequest
  - `targetUrl` string, required — The URL <a href="https://en.wikipedia.org/wiki/URL">https://en.wikipedia.org/wiki/URL</a>
  - `name` string, required — The subscription name you want to use
  - `merchantApplicationName` string, required — The name of your application
  - `merchantApplicationVersion` string, required — The version of your application
  - `merchantEmailAlert` string, email — The email

## Response `202`

Subscription creation accepted

## Other responses

- `400` — Invalid subscription request.
- `404` — The subscription is not found
- `409` — The subscription id is already used.
- `default` — Occurs when something goes wrong

---

[API](https://skmtc.dev/beezup/apis/beezup-merchant-api.md) · [All operations](https://skmtc.dev/beezup/apis/beezup-merchant-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/beezup/beezup-merchant-api/revisions/557b7feddf8a/schema)