Email

SendSeven supports both conversational email (individual back-and-forth messages) and bulk email campaigns. This guide covers setting up an email channel and sending messages.

Prerequisites

• An email integration configured in the SendSeven dashboard (SMTP/IMAP or managed delivery)
• A SendSeven API token with channels:read and messages:create scopes

Setup

Email channels are configured in the SendSeven dashboard:

1. Log in to SendSeven
2. Navigate to Settings > Channels
3. Click Add Channel > Email
4. Choose your setup method:
   • Managed by SendSeven -- SendSeven handles email delivery infrastructure
   • Bring Your Own Key (BYOK) -- connect your own email provider (SendGrid, Mailgun, AWS SES)

Email Mailboxes

Email mailboxes define sender identities (the "From" address and display name) for outbound emails. Each email channel can have multiple mailboxes.

List Mailboxes

curl -X GET "https://api.sendseven.com/api/v1/email-mailboxes" \
  -H "Authorization: Bearer s7_api_a1b2c3d4e5f6789012345678abcdef00"

{
  "items": [
    {
      "id": "mbx_001",
      "email_address": "[email protected]",
      "name": "Acme Support",
      "is_default": true
    },
    {
      "id": "mbx_002",
      "email_address": "[email protected]",
      "name": "Acme Sales",
      "is_default": false
    }
  ]
}

Send with a Specific Mailbox

When initiating an email conversation, specify from_email and from_name to use a specific sender identity:

curl -X POST "https://api.sendseven.com/api/v1/conversations/initiate" \
  -H "Authorization: Bearer s7_api_a1b2c3d4e5f6789012345678abcdef00" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": "contact_001",
    "channel_id": "ch_email_001",
    "message_type": "email",
    "email": {
      "subject": "Your order confirmation",
      "body_html": "<p>Thank you for your order!</p>",
      "from_email": "[email protected]",
      "from_name": "Acme Sales"
    }
  }'

Email Capabilities

Feature	Supported
Text	Yes
HTML content	Yes
Image (inline)	Yes
Document (attachment)	Yes
Video (inline)	Yes
Buttons	No
List messages	No
Carousel	No
Reactions	No
Read receipts (open tracking)	Yes (campaigns)

Conversational Email

Send email messages to contacts as part of a conversation:

curl -X POST "https://api.sendseven.com/api/v1/messages" \
  -H "Authorization: Bearer s7_api_a1b2c3d4e5f6789012345678abcdef00" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": "contact_email_001",
    "channel_id": "ch_email_001",
    "text": "Thank you for contacting us. We have received your inquiry and will respond within 24 hours.",
    "message_type": "text"
  }'

Email Events

Email messages generate specific webhook events with additional fields not present in standard message events:

Event	Description
email.received	Inbound email received
email.sent	Outbound email sent
email.delivered	Email delivery confirmed
email.bounced	Email bounced (hard or soft)
email.opened	Email opened by recipient
email.complained	Recipient marked email as spam

See Webhook Events for payload details.

Email Campaigns

For bulk email campaigns, SendSeven uses a 3-tier template system. See the Email Campaigns guide for details.

Pricing

Campaign emails draw from your plan's monthly included pool (shared with messages, campaign messages, and KB queries). Emails beyond the pool are billed per email — managed delivery and BYOK cost the same:

Plan	Base fee	Included pool / month	Per email beyond the pool
Basic	EUR 49	2,500	EUR 0.010
Professional	EUR 79	2,500	EUR 0.010
Scale	EUR 199	10,000	EUR 0.0075
Enterprise	EUR 499	40,000	EUR 0.005
API Only	EUR 9 per connected channel	1,000 per connected channel	EUR 0.0025

Required Scopes

Scope	Purpose
channels:create	Create an email channel
channels:read	View channel details
messages:create	Send email messages
campaigns:create	Create email campaigns
campaigns:read	View campaign analytics

Next Steps

• Email Campaigns -- bulk email campaigns with templates
• Webhook Events -- email-specific webhook events
• Manage Contacts -- managing contact email addresses