Glossary

Abbreviated public glossary of MailingCore terms.

Quick reference for terms used across the API, dashboard, and webhooks.

Term	Definition
Tenant	Isolated workspace. Own domains, templates, contacts, quota, and members. Identified by `X-Tenant-Id`.
Admin	Human user with dashboard access. Belongs to one or more tenants via membership.
API key	Server credential (`mc_live_` / `mc_test_`) with granular scopes. Shown in full only at creation.
Scope	Permission string (`email:send`, `contacts:write`, …). Missing scope → 403.
Template	Named email design. Holds one or more versions.
Template version	Immutable snapshot with status DRAFT or PUBLISHED. Sends reference a published version id.
Contact	Audience record (email, locale, opt-in, `externalId` for CRM sync).
Campaign	Newsletter send: one template fan-out to filtered contacts.
Send log	Record of one outbound message (`QUEUED`, `SENT`, `FAILED`, etc.).
Suppression	Blocked address (bounce, complaint, unsubscribe). Sends are rejected.
Webhook	HTTPS callback on events (`email.sent`, `contact.unsubscribed`, …) with HMAC signature.
Quota	Monthly email limit per plan. Headers `X-Quota-*`; hard block at 110%.
JWT	Short-lived access token for dashboard sessions (15 min) plus refresh token.
Tracking	Open pixel (`/track/o/:logId`) and click redirect (`/track/c/:logId`).
Locale routing	Picks template variant by contact `locale` with fallback chain.