Products

Create product

post https://rcur.app/api/v2/products

Requires your API key as Authorization: Bearer <key>. See authentication.

Request body

application/json

Product data

type string required

One of once subscription shipping_costs
name string required

Product name
amount number required

Product amount
vat number required

VAT percentage
interval string

Interval (required for subscription type)

One of day week month year
interval_value integer

Interval value (required for subscription type)
times integer

Number of payments (null = infinite)
woocommerce_product_id integer

WooCommerce product ID

Responses

201 Product created Product object

id string required
name string required
type string required

One of once subscription shipping_costs
amount string required
currency string required
interval string nullable
times integer nullable
wc_product_id integer nullable

422 Validation error ValidationError object

status integer required
error string required
fields object

Try it Send this request with your own API key

Requests run against the live data of the organization that owns the key. This POST request changes that data.

API key Kept in this browser tab only. Body JSON

curl -X POST https://rcur.app/api/v2/products \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "subscription",
  "name": "Premium Plan",
  "amount": 29.99,
  "vat": 21,
  "interval": "month",
  "interval_value": 1,
  "times": 12,
  "woocommerce_product_id": 1234
}'

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://rcur.app/api/v2/products', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_KEY',
        'Accept' => 'application/json',
    ],
    'json' => [
        'type' => 'subscription',
        'name' => 'Premium Plan',
        'amount' => 29.99,
        'vat' => 21,
        'interval' => 'month',
        'interval_value' => 1,
        'times' => 12,
        'woocommerce_product_id' => 1234,
    ],
]);

$data = json_decode($response->getBody(), true);

const response = await fetch('https://rcur.app/api/v2/products', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "type": "subscription",
    "name": "Premium Plan",
    "amount": 29.99,
    "vat": 21,
    "interval": "month",
    "interval_value": 1,
    "times": 12,
    "woocommerce_product_id": 1234
  }),
});

const data = await response.json();

import requests

response = requests.request(
    'POST',
    'https://rcur.app/api/v2/products',
    headers={'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'application/json'},
    json={
        "type": "subscription",
        "name": "Premium Plan",
        "amount": 29.99,
        "vat": 21,
        "interval": "month",
        "interval_value": 1,
        "times": 12,
        "woocommerce_product_id": 1234
    },
)

data = response.json()

{
    "id": "prod_abc123",
    "name": "Premium Plan",
    "type": "subscription",
    "amount": "29.99",
    "currency": "EUR",
    "interval": "month",
    "times": 12,
    "wc_product_id": 1234
}

{
    "status": 422,
    "error": "Could not process request. Some fields contain invalid data",
    "fields": {
        "email": [
            "The email field is required."
        ]
    }
}