BigMailer

BigMailer

BigMailer is a multi-brand email marketing platform for managing bulk and transactional email campaigns, contact lists, audience segments, and suppression lists. It supports multiple sender brands under a single account.

Data Model

• Brands — top-level organizational units. Every downstream resource (campaigns, contacts, lists, segments) belongs to a brand. Always fetch the brand roster first to obtain a brand_id before querying brand-scoped resources.
• Bulk campaigns — one-time or scheduled mass email sends. Statuses: draft, pending, in progress, complete, error, paused, archived, active.
• Transactional campaigns — event-triggered emails (password resets, order confirmations, etc.). Separate from bulk campaigns.
• Contacts — individual email recipients within a brand. Each contact has an email, custom field values, list memberships, unsubscribe preferences, and bounce/complaint counters. Contacts can be looked up by UUID or email address.
• Lists — named groupings of contacts used for targeting campaign sends.
• Segments — dynamic audience slices defined by conditions (operator: all/any). Used for targeted sends without manually maintaining lists.
• Custom fields — brand-level data attributes (string, integer, date) attached to contacts for personalization and segmentation.
• Message types — categories of communication (marketing, product updates, etc.) that contacts can independently unsubscribe from.
• Suppression lists — per-brand exclusion lists for bounces, complaints, and manual opt-outs. Critical for deliverability compliance.
• Users — account-level team members with roles: admin, account_manager, brand_manager, campaign_manager, template_manager. Some roles are restricted to specific brands via allowed_brands.

Hierarchy

Account → Brands → (Campaigns, Contacts, Lists, Segments, Fields, Message Types, Suppression Lists). Users are account-scoped, not brand-scoped.

Pagination

Paged collections use cursor-based pagination. Responses include a cursor field—pass it back on the next request. Default page size is 100 (max 1000).

Rate Limits

About ten requests per second per account with a small concurrency cap; back off when the service signals overload.

Common Workflows

1. Audit account structure — List all brands, then for each brand list campaigns, contacts, and lists to understand the full account topology.
2. Campaign review — Fetch all bulk or transactional campaigns for a brand to review status, delivery metrics, and scheduling.
3. Contact lookup — Retrieve a specific contact by ID or email to inspect field values, list memberships, and bounce history.
4. Audience analysis — List segments and custom fields for a brand to understand targeting capabilities.
5. Deliverability check — Review suppression lists and message type unsubscribes to assess sender reputation health.