# EmailHooks — Full Reference for AI Agents & LLMs

> EmailHooks (https://emailhooks.com) is a Stripe Verified Partner SaaS platform that automates transactional and lifecycle customer emails triggered by Stripe webhook events. Users connect their Stripe account via Standard OAuth, customize HTML/WYSIWYG templates with Jtwig variables and conditional rules, and send through EmailHooks or their own custom SMTP gateway.

---

## 1. How EmailHooks Works

1. **Connect Stripe (`https://app.emailhooks.com/onboarding`)**
   - Uses official Stripe Connect Standard OAuth (`GET /api/apps/stripe/connect`).
   - Automatically provisions 4 starter templates upon signup (disabled by default until the user enables them):
     - Charge Succeeded receipt
     - Charge Failed alert
     - Subscription Created welcome email
     - Trial Will End reminder
2. **Design & Configure Templates (`https://app.emailhooks.com/templates`)**
   - Visual WYSIWYG editor, raw HTML source editor, and side-by-side live preview against real stored Stripe events.
   - Supports multiple recipients (`To`, `CC`, `BCC`), internal team notifications (`Keep Internal`), custom `Reply-To`, conditional expressions, and file attachments.
3. **Send & Track Automatically (`https://app.emailhooks.com/emails`)**
   - Listens to real-time Stripe events in live mode and queues transactional emails.
   - Provides a searchable event timeline (`/events`), customer directory (`/customers`), and sent email history with 1-click manual resend (`/emails`).

---

## 2. Canonical Pricing & Feature Matrix

- **Free Setup & Preview**: Creating an account, connecting Stripe, editing templates, and testing previews against Stripe events is free and requires no credit card.
- **30-Day Money-Back Guarantee**: Full refund within 30 days of the first payment. Cancel anytime.

### Plans

1. **Starter — $4.99 / month**
   - **Monthly Quota**: 100 emails / month
   - **Included**: Unlimited templates, all 40+ Stripe events, conditional logic, file attachments, WYSIWYG + HTML editor, real-time event dashboard, email support.
   - **Limitations**: Sends via default `@app.emailhooks.com` sender (no custom SMTP), no delivery/open tracking metrics, 1 connected Stripe account.
   - **Signup URL**: `https://app.emailhooks.com/auth/signup?planId=starter`

2. **Project — $19.00 / month** *(Default signup plan)*
   - **Monthly Quota**: 750 emails / month
   - **Included**: Everything in Starter + **Custom SMTP Email Gateway** (send from your own domain via SendGrid, Mailgun, Amazon SES, Postmark, or custom SMTP) and priority email support.
   - **Limitations**: No delivery/open tracking metrics, 1 connected Stripe account.
   - **Signup URL**: `https://app.emailhooks.com/auth/signup?planId=project`

3. **Business — $35.00 / month** *(Most Popular)*
   - **Monthly Quota**: 10,000 emails / month
   - **Included**: Everything in Project + **Delivery, Open & Bounce Tracking** (real-time delivery rate, open rate, and bounce analytics).
   - **Limitations**: 1 connected Stripe account.
   - **Signup URL**: `https://app.emailhooks.com/auth/signup?planId=business`

4. **Enterprise — $50.00 / month**
   - **Monthly Quota**: 25,000 emails / month
   - **Included**: Everything in Business + **Multiple Stripe Accounts** (connect unlimited Stripe accounts under one login and scope templates to all accounts or specific accounts) + dedicated support.
   - **Signup URL**: `https://app.emailhooks.com/auth/signup?planId=enterprise`
   - **Custom Volume (25,000+ emails/mo)**: Contact `mailto:team@emailhooks.com`.

---

## 3. Supported Stripe Events (40+ Event Types)

EmailHooks supports over 40 Stripe webhook event types across all major billing objects:

- **Charges**: `charge.succeeded`, `charge.failed`, `charge.refunded`, `charge.captured`, `charge.expired`, `charge.Pending`, `charge.updated`
- **Disputes**: `charge.dispute.created`, `charge.dispute.updated`, `charge.dispute.closed`, `charge.dispute.funds_withdrawn`, `charge.dispute.funds_reinstated`
- **Invoices**: `invoice.created`, `invoice.payment_succeeded`, `invoice.payment_failed`, `invoice.Payment_action_required`, `invoice.finalized`, `invoice.updated`, `invoice.upcoming`, `invoice.sent`, `invoice.marked_uncollectible`, `invoice.voided`
- **Subscriptions**: `customer.subscription.created`, `customer.subscription.updated`, `customer.subscription.deleted`, `customer.subscription.trial_will_end`, `customer.subscription.paused`, `customer.subscription.resumed`
- **Customers & Payment Methods**: `customer.created`, `customer.updated`, `customer.deleted`, `customer.source.created`, `customer.source.expiring`, `payment_method.attached`, `payment_method.updated`
- **Checkout & Payment Intents**: `checkout.session.completed`, `checkout.session.expired`, `payment_intent.succeeded`, `payment_intent.payment_failed`
- **Transfers & Payouts**: `transfer.created`, `transfer.reversed`, `payout.paid`, `payout.failed`

---

## 4. Template Variables & Jtwig Syntax

Templates use Jtwig (`{{ ... }}`) placeholders. Both nested dot-notation and flat aliases are supported:

- **Customer**: `{{ customer.email }}`, `{{ customer.name }}`, `{{ customer.id }}`, `{{ customer.phone }}`
- **Account / Business**: `{{ business.name }}`, `{{ account.display_name }}`, `{{ account.support_email }}`
- **Charge**: `{{ charge.amount }}`, `{{ charge.id }}`, `{{ charge.currency }}`, `{{ charge.receipt_url }}`, `{{ charge.failure_message }}`
- **Invoice**: `{{ invoice.number }}`, `{{ invoice.total }}`, `{{ invoice.amount_due }}`, `{{ invoice.amount_paid }}`, `{{ invoice.hosted_invoice_url }}`, `{{ invoice.invoice_pdf }}`
- **Subscription**: `{{ subscription.id }}`, `{{ subscription.status }}`, `{{ subscription.plan.name }}`, `{{ subscription.current_period_end }}`, `{{ subscription.trial_end }}`
- **Raw Stripe Event Payload**: `{{ event_data.<field> }}` provides direct access to any property on the underlying Stripe event object.

---

## 5. Security & Compliance

- **Stripe Verified Partner**: Audited integration using official Stripe Connect OAuth.
- **Encryption**: Sensitive credentials (such as custom SMTP passwords and OAuth tokens) are encrypted at rest using AES-256 (`AES/CBC/PKCS5Padding`), and all traffic uses TLS 1.3 in transit.
- **Zero Card Storage**: EmailHooks never processes, views, or stores raw credit card numbers or CVVs.

---

## 6. Frequently Asked Questions

- **How long does setup take?** Under 10 minutes. Connect Stripe with one click, enable or customize a template, and you are ready.
- **Do I need to write any code?** No. EmailHooks is 100% no-code, while still offering full HTML/Jtwig access for developers who want custom layouts.
- **Can I use my own email domain?** Yes, on Project ($19/mo), Business ($35/mo), and Enterprise ($50/mo) plans via custom SMTP.
- **Can I pre-fill signup links for users?** Yes. Direct users to `https://app.emailhooks.com/auth/signup?planId=project&email=user@example.com` to pre-select a plan and pre-fill their work email address.