Skip to main content

Mailboxes

A mailbox is a sender identity: the From address and display name that recipients see on your outbound email. A single connection can have several mailboxes (for example [email protected] and [email protected]), and one is marked as the default.

Mailboxes control who the email appears to be from; the connection controls how it is actually delivered.

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
    }
  ]
}

Choosing the sender when you send​

When you compose or reply, you can override the sender. Discover which senders are available for a given conversation with the sender-options endpoint:

curl -X GET "https://api.sendseven.com/api/v1/conversations/conv_email_99/sender-options" \
  -H "Authorization: Bearer s7_api_a1b2c3d4e5f6789012345678abcdef00"

Pass the chosen id as sender_id on a reply or compose request. When omitted, the default mailbox / reply sender is used. See Sending email.

Sender address on a new conversation​

When initiating an email conversation, set from_email and from_name to pick the 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"
    }
  }'
Deliverability

The From address must belong to a sending domain you have verified on the connection (see Integration types). Sending from an unverified domain will be rejected.

Next steps​