Tags API
The tags surface gives integrations a lightweight way to reason about subscriber labels and create new tagging primitives without using the app UI.
3 min read
Manage tags
Tags stay intentionally lightweight. They are ideal for flexible labels that power targeting, imports, forms, and automation entry conditions.
Endpoints
Read the current tag catalog or create tags programmatically before you push new subscribers into a workspace.
GET
/v1/tags List tags
Returns tags in the authenticated workspace.
View schema POST
/v1/tags Create a tag
Creates a new tag in the authenticated workspace.
View schemaCreate tags programmatically
Create a tag
curl -X POST https://api.mailrith.com/v1/tags \
-H "Authorization: Bearer mrk_example_secret_key" \
-H "Content-Type: application/json" \
-d '{
"name": "Webinar 2026",
"description": "Applied to everyone who registered for the April webinar",
"double_opt_in_enabled": false
}'Need help shipping an integration?
Reach the Mailrith team if you need help planning a sync, validating a webhook flow, or troubleshooting a request.