> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mailofly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Topics

> Configure granular subscription topics and preference centers for contacts.

# Topics

Topics represent distinct subscription categories (e.g., Product Updates, Newsletter, Security Alerts).

## Managing Contact Preferences

Instead of an all-or-nothing unsubscribe, topics allow contacts to opt out of marketing communications while remaining subscribed to critical product notifications.

### Assigning Topics via API

```bash theme={null}
curl -X PATCH "https://api.mailofly.com/api/contacts/con_01J8G52XYZ" \
  -H "Authorization: Bearer mf_live_..." \
  -d '{
    "topics": ["product_updates", "weekly_digest"]
  }'
```


## Related topics

- [Why use Topics?](/guides/sending/why-use-topics.md)