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

EnvironmentBase URL
Stagehttps://preferences-stage.cortextech.io
Productionhttps://preferences.cortextech.io

Postman Collection

For full request/response examples, use the Postman collection:

Preferences Centre 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 TypeAuth MethodDescription
User endpointsBearer JWT or no authFan-facing endpoints. When called without a Bearer token, returns preference definitions only. With a Bearer token, returns the fan's selected options.
Admin endpointsBearer JWT (admin)Server-side endpoints for managing preference definitions, options, and fan preferences. Requires an admin-level JWT.