Preferences Centre API
Preferences Centre API
The Preferences Centre allows you to capture, store, and manage fan preferences. This includes handling compliance requirements such as GDPR marketing opt-ins/opt-outs, as well as gathering insights about individual fans to personalise their experiences.
For a full overview of the Preferences Centre, including UI screenshots and conceptual guidance, see the Unified Preference Centre Guide.
Environments
| Environment | Base URL |
|---|---|
| Stage | https://preferences-stage.cortextech.io |
| Production | https://preferences.cortextech.io |
Postman Collection
For full request/response examples, use the Postman collection:
API Reference
The full interactive API Reference with request/response schemas is available in the Preferences Centre API Reference.
Authentication
The Preferences Centre uses two authentication methods depending on the endpoint:
| Endpoint Type | Auth Method | Description |
|---|---|---|
| User endpoints | Bearer JWT or no auth | Fan-facing endpoints. When called without a Bearer token, returns preference definitions only. With a Bearer token, returns the fan's selected options. |
| Admin endpoints | Bearer JWT (admin) | Server-side endpoints for managing preference definitions, options, and fan preferences. Requires an admin-level JWT. |
Updated about 14 hours ago
