Skip to main content
Use the REST API to create a paywall under a service. For the dashboard path, see Add a paywall.

Endpoint

Requires scope paywalls:write. See Authentication.

Example

price is USDC in micro-units (6 decimals) as a string. "1000000" = $1.00. "50000" = $0.05.

Request body

Merchant wallet is set automatically to your Proceeds wallet — do not pass it. A duplicate slug in the same service returns 409.

Payment URLs after create

MPP URLs require Tempo on the paywall networks. See Payment URLs.
  • GET /v1/paywalls — list (serviceId, enabled filters)
  • GET /v1/paywalls/{id} — get
  • PATCH /v1/paywalls/{id} — update
  • DELETE /v1/paywalls/{id} — delete

Make your first payment

Pay the new URL end-to-end from an agent.

API overview

Envelope, pagination, and conventions.