Buttondown logo

Creating a price

Sample requests

These sample requests are autogenerated by the OpenAPI spec.

import requests

url = "https://api.buttondown.com/v1/prices"
headers = {
  "Authorization": "Token $BUTTONDOWN_API_KEY"
}

response = requests.request("POST", url, headers=headers)
print(response.text)

Sample responses

The IDs and values referenced in these responses are fake; please only rely on these responses for overall structure.

{
    "amount": 1000,
    "cadence": "month",
    "currency": "usd",
    "description": null,
    "maximum_amount": null,
    "minimum_amount": null,
    "product_id": "prod_123",
    "style": "fixed",
    "suggested_amount": null,
    "id": "price_123",
    "product": null
}

Body parameters

All parameters are optional unless explicitly specified.

amount

Type
Description

The price amount in the smallest currency unit (e.g. cents).

cadence

Type
string · required
Description

The billing cadence for this price.

currency

Type
string · required
Description

The three-letter ISO currency code (e.g. 'usd').

description

Type
Description

An optional human-readable description of the price.

maximum_amount

Type
Description

The maximum amount for pay-what-you-want prices.

minimum_amount

Type
Description

The minimum amount for pay-what-you-want prices.

product_id

Type
Description

The ID of the Stripe product this price belongs to.

style

Type
string · required
Description

The pricing style: 'fixed', 'pay-what-you-want', or 'usage-based'.

suggested_amount

Type
Description

The suggested amount for pay-what-you-want prices.