API Reference

# SEP Integrations

Connect your Mission Inbox mailboxes to Sales Engagement Platforms (SEPs) for outbound campaign sending. All endpoints run asynchronously and return a task ID for progress monitoring.

## Overview

| Method | Endpoint                               | Description                                 |
| ------ | -------------------------------------- | ------------------------------------------- |
| POST   | /api/mailboxes/bulk-connect-instantly  | Connect specific mailboxes to Instantly     |
| POST   | /api/mailboxes/bulk-connect-smartlead  | Connect specific mailboxes to SmartLead     |
| POST   | /api/mailboxes/bulk-connect-emailbison | Connect specific mailboxes to EmailBison    |
| POST   | /api/mailboxes/connect-all-instantly   | Connect ALL product mailboxes to Instantly  |
| POST   | /api/mailboxes/connect-all-smartlead   | Connect ALL product mailboxes to SmartLead  |
| POST   | /api/mailboxes/connect-all-emailbison  | Connect ALL product mailboxes to EmailBison |

Supported platforms

Instantly

Cold email outreach platform with auto-warmup and campaign management.

![SmartLead](/src/assets/smartlead.png)

SmartLead

Multi-channel outreach platform with smart inbox rotation.

![EmailBison](/src/assets/emailbison.png)

EmailBison

Email outreach platform for automated campaign sending.

Your platform API key must be configured in your Mission Inbox dashboard under **Settings → SEP Integration** before using these endpoints.

All three endpoints follow the same pattern — accept an array of emails and return a `taskId`. Use the `GET /api/tasks/:id` endpoint to monitor connection progress.

POST`/api/mailboxes/bulk-connect-instantly`

## Connect to Instantly

Connects the specified mailboxes to your Instantly account. Mailboxes are added to your Instantly workspace and become available as sending accounts for campaigns.

| Field        | Type          | Required | Description                                                                                                               |
| ------------ | ------------- | -------- | ------------------------------------------------------------------------------------------------------------------------- |
| emails       | string\[\]    | Required | Array of mailbox email addresses to connect                                                                               |
| credentialId | string (uuid) | Optional | Which Instantly connection to push to, when your organization has more than one. Defaults to the first active connection. |

cURL

```bash
curl -X POST "https://api.v4.missioninbox.com/api/mailboxes/bulk-connect-instantly" \
  -H "X-Server-API-Key: miacme_4eC8vKmN2pQrStUwXyZaB6dEfGhIjLoPqRsT9uVwX1b" \
  -H "Content-Type: application/json" \
  -d '{
    "emails": [
      "sender1@yourdomain.com",
      "sender2@yourdomain.com"
    ]
  }'
```

Response

```json
{
  "taskId": "550e8400-e29b-41d4-a716-446655440000",
  "message": "Connect Instantly task created for 2 mailbox(es)"
}
```

![SmartLead](/src/assets/smartlead.png)

POST`/api/mailboxes/bulk-connect-smartlead`

## Connect to SmartLead

Connects the specified mailboxes to your SmartLead account. Mailboxes are registered as sending accounts and available for multi-channel outreach campaigns.

| Field        | Type          | Required | Description                                                                                                               |
| ------------ | ------------- | -------- | ------------------------------------------------------------------------------------------------------------------------- |
| emails       | string\[\]    | Required | Array of mailbox email addresses to connect                                                                               |
| credentialId | string (uuid) | Optional | Which SmartLead connection to push to, when your organization has more than one. Defaults to the first active connection. |

cURL

```bash
curl -X POST "https://api.v4.missioninbox.com/api/mailboxes/bulk-connect-smartlead" \
  -H "X-Server-API-Key: miacme_4eC8vKmN2pQrStUwXyZaB6dEfGhIjLoPqRsT9uVwX1b" \
  -H "Content-Type: application/json" \
  -d '{
    "emails": [
      "sender1@yourdomain.com",
      "sender2@yourdomain.com"
    ]
  }'
```

Response

```json
{
  "taskId": "550e8400-e29b-41d4-a716-446655440000",
  "message": "Connect Smartlead task created for 2 mailbox(es)"
}
```

![EmailBison](/src/assets/emailbison.png)

POST`/api/mailboxes/bulk-connect-emailbison`

## Connect to EmailBison

Connects the specified mailboxes to your EmailBison account. Mailboxes are linked and available for automated campaign sending.

| Field        | Type          | Required | Description                                                                                                                |
| ------------ | ------------- | -------- | -------------------------------------------------------------------------------------------------------------------------- |
| emails       | string\[\]    | Required | Array of mailbox email addresses to connect                                                                                |
| credentialId | string (uuid) | Optional | Which EmailBison connection to push to, when your organization has more than one. Defaults to the first active connection. |

cURL

```bash
curl -X POST "https://api.v4.missioninbox.com/api/mailboxes/bulk-connect-emailbison" \
  -H "X-Server-API-Key: miacme_4eC8vKmN2pQrStUwXyZaB6dEfGhIjLoPqRsT9uVwX1b" \
  -H "Content-Type: application/json" \
  -d '{
    "emails": [
      "sender1@yourdomain.com",
      "sender2@yourdomain.com"
    ]
  }'
```

Response

```json
{
  "taskId": "550e8400-e29b-41d4-a716-446655440000",
  "message": "Connect EmailBison task created for 2 mailbox(es)"
}
```

POST`/api/mailboxes/connect-all-{provider}`

## Connect All Mailboxes

Each platform also has a **connect-all** variant that connects _every_ mailbox in your product in a single call — no request body required. To push to a specific connection when you have more than one for the platform, send `{ "credentialId": "..." }`; without it the first active connection is used. The mailbox list is resolved server-side from your product API key, so there is no client-side cap. Mailboxes already connected are treated as a no-op.

| Method | Endpoint                              | Description                                 |
| ------ | ------------------------------------- | ------------------------------------------- |
| POST   | /api/mailboxes/connect-all-instantly  | Connect all product mailboxes to Instantly  |
| POST   | /api/mailboxes/connect-all-smartlead  | Connect all product mailboxes to SmartLead  |
| POST   | /api/mailboxes/connect-all-emailbison | Connect all product mailboxes to EmailBison |

Like the targeted endpoints, each returns a `taskId` — the response message reports how many mailboxes were queued. Monitor progress via `GET /api/tasks/:id`.

cURL

```bash
curl -X POST "https://api.v4.missioninbox.com/api/mailboxes/connect-all-instantly" \
  -H "X-Server-API-Key: miacme_4eC8vKmN2pQrStUwXyZaB6dEfGhIjLoPqRsT9uVwX1b"
```

Response

```json
{
  "taskId": "550e8400-e29b-41d4-a716-446655440000",
  "message": "Connect Instantly task created for 142 mailbox(es)"
}
```

[PreviousHealth Checks](https://doc.v4.missioninbox.com/sales/api/health-checks.md)[NextSupport & Resources](https://doc.v4.missioninbox.com/sales/support.md)
