Skip to content
Splashify Pro
Email docsEmail

Concepts

A short tour of the primitives the API exposes.

The 5 primitives

text
┌─────────────────────────────────────────────────────────┐
│              Your Splashify Pro account                 │
│                                                         │
│  ┌───────────────┐  ┌───────────────┐  ┌─────────────┐ │
│  │   Identity    │  │  Identity     │  │  Identity   │ │
│  │ (your domain) │  │  (alt addr)   │  │  (3rd domain)│ │
│  └───────┬───────┘  └───────┬───────┘  └──────┬──────┘ │
│          │ verified         │ verified        │ pending │
│  ┌───────┴──────────────────┴─────────────────┴──────┐ │
│  │              Configuration Sets                    │ │
│  │   ┌──────────────┐  ┌──────────────┐               │ │
│  │   │ "production" │  │ "marketing"  │               │ │
│  │   │  ↓ events     │  │  ↓ events    │               │ │
│  │   │  → webhook A  │  │  → webhook B │               │ │
│  │   │  → webhook B  │  │              │               │ │
│  │   └──────────────┘  └──────────────┘               │ │
│  └────────────────────────────────────────────────────┘ │
│  ┌────────────────────────────────────────────────────┐ │
│  │           Suppression list (account-wide)           │ │
│  │  [email protected]    [email protected]  ...      │ │
│  └────────────────────────────────────────────────────┘ │
│                                                         │
│  Wallet: ₹X.XX                       Sandbox: ON / OFF  │
└─────────────────────────────────────────────────────────┘
  1. Sending identities — verified domains + email addresses you can send From:.
  2. Configuration sets — logical groupings of sends that route events to webhook destinations.
  3. Suppression list — account-wide blocklist. Auto-populated by hard bounces + complaints + unsubscribes.
  4. Reputation: your account's bounce + complaint rate. High rates mark you AT_RISK, but rates alone pause nobody.
  5. Sandbox vs production: sandbox = 200/day cap, free, to any address. Production = real volume after a quick review.

Hierarchy

  • Identity is account-wide. Verifying acme.com lets you send from any address at acme.com.
  • Configuration set scopes sends — events from sends inside a config set go to that set's webhook destinations.
  • Suppression list is account-wide. Each config set decides, via suppression_options, which of its bounces and complaints are added to that list.

Send-time flow

text
POST /send (with config_set + from + to)
     │
     ▼
1. From-domain on a verified identity? ──── no → 400 FROM_NOT_VERIFIED
     │ yes
     ▼
2. Recipient on suppression list? ──── yes → status=rejected
     │ no
     ▼
3. Daily limit not reached? ──── no → 429 DAILY_LIMIT_REACHED
     │ yes
     ▼
4. Wallet balance >= ₹0.03? ──── no → 402 INSUFFICIENT_BALANCE
     │ yes (or in sandbox free tier)
     ▼
5. Queue the email for delivery
     │
     ▼
6. Fire "Send" event → webhook destinations
     │
     ▼
7. SMTP attempt → recipient MX
     ├── 250 OK → "Delivery" event
     ├── 5xx hard bounce → "Bounce" event + suppress
     └── 4xx soft bounce → "DeliveryDelay" event + retry
                           (5min, 15min, 1h, 3h, 6h, 12h)
                           7th failure → "Bounce" event + suppress