AttuneMail DocsTroubleshooting
Getting started

Core concepts

Understand connections, events, customers, journeys, goals, consent, and sending identities before building automation.

Updated 2026-08-236 min

The signal-to-email flow

  1. 01

    A connection authenticates the source

    Each source has its own credential, status, event contract, and operational counters.

  2. 02

    An event records something that happened

    Track calls, identity updates, provider webhooks, hosted form submissions, and internal activity enter a common customer-event ledger.

  3. 03

    Identity resolves the customer

    Source-scoped user, anonymous, group, and alias IDs link activity to one customer record when sufficient identity is present.

  4. 04

    A journey evaluates the signal

    Trigger conditions, delays, goal exits, suppression state, and sender readiness determine the next eligible action.

  5. 05

    A reviewed email is sent

    The email uses grounded customer context and an approved sending identity. Sending never overrides consent or suppression.

Objects you will work with

ObjectPurposePractical rule
ConnectionAuthenticates and labels an event sourceUse separate production and staging connections
EventImmutable evidence that something happenedUse stable names and message IDs
CustomerResolved person, identifiers, traits, and consent statePrefer your durable application user ID
JourneyTrigger, conditions, actions, waits, and exitsDefine the goal before activating
GoalThe outcome that stops or measures a journeyChoose a customer behavior, not an email metric
Sending identityVerified From address and reply behaviorComplete domain authentication first

Separate environments

Use distinct connections for local development, staging, and production. A connection is an operational and identity boundary, so this prevents test events from enrolling real customers and makes rotation safer.