BizKitHub
DocsAPI ReferenceSubscription/bff/subscription/create-for-contact
postSubscriptionAdmin BFF

/bff/subscription/create-for-contact

Creates a zero-price paid order for the given subscription product and marks it as paid, which triggers the standard subscription-start rule (writeSubscriptionByOrder). Same effect as if the customer had bought and paid — invoice + activity behave identically. Fails if the product does not have a shop__product_subscription_plan row or does not belong to the current organisation.

SubscriptionpostBffSubscriptionCreate-for-contact

Parameters

JSON body

Request body

application/json
customerIdstringRequired

Contact external ID.

Exampleabc123def456ghij
productCodestringRequired

Product code with an attached subscription plan.

Examplekurz-mesicni

Response schema

1 status code documented

200Success
success"true"Required
orderNumberstringRequired
orderHashstringRequired

Response example

application/json
{
  "success": true,
  "orderNumber": "example_orderNumber",
  "orderHash": "example_orderHash"
}

Request example

POST /bff/subscription/create-for-contact

post
curl -X POST "https://api.bizkithub.com/bff/subscription/create-for-contact" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "customerId": "abc123def456ghij",
  "productCode": "kurz-mesicni"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key