Sign in
latestOpenAPI 3.1.02026-08-211061591.1 MB

69a962f1578f

Billing

Usage Billing Top Up

In V1, create a hosted Stripe Checkout session to top up the authenticated user's personal Automations wallet.

The user must have a personal Stripe customer and an active personal Todoist Pro subscription. A Business or workspace subscription alone does not qualify. A Business member who also has personal Todoist Pro tops up their personal wallet.

If the personal Stripe customer or personal Todoist Pro prerequisite is not met, the endpoint returns HTTP 400 with error tag USAGE_BILLING_TOP_UP_UNAVAILABLE and error code 605.

post/api/v1/usage_billing/top_up

Request body

amountinteger required

Amount to buy, in the currency's minor unit (1000 = $10.00).

currencystring required

ISO currency code.

return_urlstring required

URL Checkout returns the user to.

Example request

{
  "amount": 1000,
  "currency": "usd",
  "return_url": "https://todoist.com/app/settings/automations"
}

Response

Successful Response

session_idstring required

The created Stripe Checkout session id.

checkout_urlstring required

Hosted Stripe Checkout URL to redirect the user to for payment.

Example response

{
  "session_id": "cs_live_a1b2c3",
  "checkout_url": "https://checkout.stripe.com/c/pay/cs_live_a1b2c3"
}