# Superwall Paywalls V2 API

**Canonical:** https://apis.io/apis/superwall/superwall-paywalls-v2-api/  
**Provider:** Superwall — https://apis.io/providers/superwall/  
**Base URL:** https://api.superwall.com  
**Documentation:** https://api.superwall.com/docs

Superwall Paywalls V2 API is one of 42 APIs that [Superwall](https://apis.io/providers/superwall/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Paywalls V2. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Manage paywalls and paywall templates. A Paywall is a monetization screen shown to users. Paywalls are scoped to a specific application (per-platform) since their design and behavior are platform-specific.

## Operations (17)

| Method | Path | Summary |
|---|---|---|
| GET | `/v2/paywalls` | List Paywalls |
| POST | `/v2/paywalls` | Create Paywall |
| GET | `/v2/paywalls/templates/{id}` | Retrieve Paywall Template |
| POST | `/v2/paywalls/{id}/preview-token` | Create Paywall Preview Token |
| GET | `/v2/paywalls/{id}/preview-images` | Retrieve Paywall Preview Images |
| GET | `/v2/paywalls/{id}` | Retrieve Paywall |
| PATCH | `/v2/paywalls/{id}` | Update Paywall |
| POST | `/v2/paywalls/{id}/publish` | Publish Paywall |
| POST | `/v2/paywalls/{id}/versions` | Push Headless Version |
| GET | `/v2/paywalls/{id}/versions` | List Headless Versions |
| POST | `/v2/paywalls/{id}/assets` | Sync Headless Assets |
| POST | `/v2/paywalls/{id}/source-access` | Mint Headless Source Access |
| POST | `/v2/paywalls/{id}/versions/{version}/source-commit` | Link Headless Source Commit |
| POST | `/v2/paywalls/{id}/promote` | Promote Headless Version |
| POST | `/v2/paywalls/{id}/duplicate` | Duplicate Paywall |
| POST | `/v2/paywalls/{id}/archive` | Archive Paywall |
| POST | `/v2/paywalls/{id}/unarchive` | Unarchive Paywall |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/superwall/openapi/superwall-paywalls-v2-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/superwall/json-schema/superwall-audit-log-entry-with-actor-schema.json
- **JSONSchema** — https://artifacts.apis.io/superwall/json-schema/superwall-custom-store-event-schema.json
- **JSONSchema** — https://artifacts.apis.io/superwall/json-schema/superwall-rule-conditions-schema.json
- **JSONSchema** — https://artifacts.apis.io/superwall/json-schema/superwall-rule-conditions-1-schema.json
- **JSONSchema** — https://artifacts.apis.io/superwall/json-schema/superwall-doctor-report-schema.json
- **JSONSchema** — https://artifacts.apis.io/superwall/json-schema/superwall-audit-log-list-schema.json

## Other Superwall APIs (12)

- [Superwall App Store Connect Configurations V2 API](https://apis.io/apis/superwall/superwall-app-store-connect-configurations-v2-api/)
- [Superwall App User Erasures V2 API](https://apis.io/apis/superwall/superwall-app-user-erasures-v2-api/)
- [Superwall Application Webapp Origins V2 API](https://apis.io/apis/superwall/superwall-application-webapp-origins-v2-api/)
- [Superwall Assets V2 API](https://apis.io/apis/superwall/superwall-assets-v2-api/)
- [Superwall Audit Logs V2 API](https://apis.io/apis/superwall/superwall-audit-logs-v2-api/)
- [Superwall Campaigns V2 API](https://apis.io/apis/superwall/superwall-campaigns-v2-api/)
- [Superwall Chart Annotations API](https://apis.io/apis/superwall/superwall-chart-annotations-api/)
- [Superwall Charts V2 API](https://apis.io/apis/superwall/superwall-charts-v2-api/)
- [Superwall CLI Agent V2 API](https://apis.io/apis/superwall/superwall-cli-agent-v2-api/)
- [Superwall Custom Store Events API](https://apis.io/apis/superwall/superwall-custom-store-events-api/)
- [Superwall Custom Stores API](https://apis.io/apis/superwall/superwall-custom-stores-api/)
- [Superwall Demand Score V2 API](https://apis.io/apis/superwall/superwall-demand-score-v2-api/)

## Tags

Paywalls V2

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/superwall/superwall-paywalls-v2-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/superwall/.