Skip to main content

Email

SendSeven supports both conversational email (one-to-one back-and-forth inside a conversation) and bulk email campaigns (newsletters). This page is a quick channel overview and setup summary.

In-depth email documentation

For the full reference — connection types and when to choose which, mailboxes, sending, attachments, opt-in, and unsubscribe handling — see the dedicated Email section.

Prerequisites

  • An email connection configured in the SendSeven dashboard
  • A SendSeven API token with channels:read and messages:create scopes

Setup

Email is configured in the SendSeven dashboard:

  1. Log in to SendSeven.
  2. Navigate to Settings > Email Configuration (email is not set up under Settings > Channels).
  3. Add a connection and choose the type that fits your use case.

What each connection type can do — and which one to pick for sending campaigns vs. receiving support email — is covered in Integration types & when to choose. Sending connections also require domain verification, described there.

Capabilities

FeatureSupported
TextYes
HTML contentYes
Image (inline)Yes
Document (attachment)Yes
Video (inline)Yes
ButtonsNo
List messagesNo
CarouselNo
ReactionsNo
Read receipts (open tracking)Yes (campaigns)

Sending a message

Send a conversational email with the unified POST /messages endpoint:

curl -X POST "https://api.sendseven.com/api/v1/messages" \
-H "Authorization: Bearer s7_api_a1b2c3d4e5f6789012345678abcdef00" \
-H "Content-Type: application/json" \
-d '{
"conversation_id": "conv_email_99",
"subject": "Your inquiry",
"text": "Thank you for contacting us. We will respond within 24 hours.",
"message_type": "text"
}'

Email requires a subject, sender identities are managed as mailboxes, and attachments follow a specific flow — all covered in the Email section: Sending email, Mailboxes, and Attachments.

Email events

Email produces dedicated webhook events with fields beyond standard message events:

EventDescription
email.receivedInbound email received
email.sentOutbound email sent
email.deliveredEmail delivery confirmed
email.bouncedEmail bounced (hard or soft)
email.openedEmail opened by recipient
email.complainedRecipient marked email as spam

See Webhook Events for payload details.

Email campaigns

For bulk newsletters, see the Email Campaigns guide. Opt-in and unsubscribe handling are covered in the Email section under Opt-in and Subscriptions & unsubscribe.

Required scopes

ScopePurpose
channels:readView channel details
messages:createSend email messages
campaigns:createCreate email campaigns
campaigns:readView campaign analytics

Next steps