Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.omneo.io/llms.txt

Use this file to discover all available pages before exploring further.

The comms preference centre is where customers control what types of communications they receive from your brand. It is built into the Profile Portal and does not require custom development.

​
What customers can manage

The preference centre exposes the communication consent fields stored on the Omneo profile:
FieldWhat it controls
email_optinGlobal email marketing opt-in
sms_optinSMS marketing opt-in
push_optinPush notification opt-in (if app is active)
Category preferencesOpt in or out of specific communication categories (e.g., new arrivals, sale alerts, event invites)
Customers can update their preferences at any time. Changes are applied to their Omneo profile immediately and reflected in any reactions that filter on opt-in status.

​
How it works in the Profile Portal

The Profile Portal includes a pre-built Preferences section accessible from the customer’s account navigation. The page renders dynamically based on which consent fields your instance has configured. Customers can:
  • Toggle global email/SMS opt-in on or off
  • Select which email categories they want to receive (if category preferences are enabled)
  • Save changes with a single click
Changes are applied in real time — there is no delay or approval step.

​
Australian Spam Act compliance

For Australian brands, the comms preference centre supports compliance with the Spam Act 2003 requirements:
  • Customers must have consented before receiving commercial electronic messages
  • An unsubscribe mechanism must be available in every commercial message — the Profile Portal preference centre link serves this purpose
  • Unsubscribe requests must be honoured within 5 business days — Omneo applies opt-out changes immediately
Link the preference centre URL in every marketing email’s footer as your unsubscribe mechanism. The URL is the Profile Portal preferences page, authenticated via magic link. Reactions that send marketing communications should filter on opt-in status. For example, a reward earned notification would still send (transactional), but a promotional campaign should filter to only send to profiles where email_optin = true. Example reaction filter: 
{
  "filters": [
    {
      "attribute": "email_optin",
      "operator": "==",
      "value": true
    }
  ]
}

​
Syncing preferences to your comms platform

When a customer updates their preferences in the Profile Portal, Omneo can fire a reaction on profile.updated to sync the new preferences to your comms platform (Klaviyo, SFMC, Braze, etc.). This keeps your suppression lists in both systems aligned. The target payload for a preference sync should include:
  • Email address (as the comms platform identifier)
  • Current value of all consent fields

​
Category preferences

If your brand sends multiple distinct communication types (new arrivals, sale alerts, event invitations, replenishment reminders), you can configure category-level consent. Each category maps to a custom attribute on the Omneo profile, and the preference centre renders a toggle for each active category. Category preference configuration requires setup by your Omneo implementation partner to define the custom attribute fields and configure the Profile Portal preference centre UI.

​
Bounce handling

Email bounces should be fed back to Omneo via your comms platform. Hard bounces (invalid email address) should trigger a profile update that sets email_optin = false and notes the bounce reason. This prevents continued send attempts to known-bad addresses. Your comms platform can send bounce events to Omneo via a target (webhook in reverse), or your implementation partner can configure a sync to handle this automatically.