Click Management API
The Propper Click API provides consent and clickwrap management for websites and applications. Create templates, publish versioned policies, deploy them to domains, and collect legally-binding acceptance records with full evidence bundles.
Base URL
https://api.propper.ai/v1/click
Authentication
OAuth 2.0 Bearer token:
Authorization: Bearer <access_token>
OAuth Scopes
click:admin— Full administrative access (create, update, delete)click:read— Read-only access to templates, deployments, and acceptances
Key Endpoints
- Templates — Create and manage consent/clickwrap templates
- Template Versions — Publish, archive, and manage versioned content
- Deployments — Deploy templates to domains and control activation
- Acceptances — View acceptance records and evidence bundles
Request correlation
Every response (success and error) includes an x-request-id header (a UUID) and a traceparent header (W3C Trace Context). Error bodies also carry the same id as requestId. Quote x-request-id when contacting support to pinpoint the exact request, and use it to correlate the API with your own logs. Send your own traceparent to tie a multi-call workflow under one trace.
Authentication
- HTTP: Bearer Auth
- HTTP: Basic Auth
OAuth 2.0 Bearer token
Security Scheme Type: | http |
|---|---|
HTTP Authorization Scheme: | bearer |
Bearer format: | JWT |
HTTP Basic authentication using an organization API key as the username (legacy SDK compatibility).
Security Scheme Type: | http |
|---|---|
HTTP Authorization Scheme: | basic |