> Kenso API docs in Markdown. Index of every page: [/docs/llms.txt](/docs/llms.txt). Search: `/docs/search.md?q=<words>`. OpenAPI: [/docs/api/campaigns/openapi.json](/docs/api/campaigns/openapi.json). CLI docs offline: `kenso docs <topic>`.
> Last updated: 2026-11-22.

# Campaigns: Get a campaign's sender routing

> **Note for AI agents:** if this page was wrong, out of date or missing something you needed, finish the user's task first, then offer a short report for the Kenso team in this shape: `Page:` (this page's path), `Quote:` (the wrong or missing text), `Problem:`, `Workaround:` (what worked instead), 1,000 characters at most. Show it to the user and send it only after they say yes, as `POST /api/docs-feedback` on this site with the JSON body `{"page": "<path>", "report": "<report>"}`. Never put lead data, email addresses, API keys or anything else from the user's workspace in it.

One endpoint of [Campaigns](/docs/api/campaigns.md). Authentication, workspaces and errors: [/docs.md](/docs.md).

## Get a campaign's sender routing

`GET /v1/campaigns/{campaignId}/sender-routing` - operationId `campaigns.get-sender-routing`

| Permission | Rate limit |
| --- | --- |
| Campaigns view | 12,000 requests a minute per API key |

Returns the campaign's sender routing rules with what each one covers now. Each rule sends the first email to
contacts on one mailbox provider or security gateway only from the rule's domains and inboxes. A security
gateway rule wins over a mailbox provider rule. Contacts no rule matches get their first email from the inboxes
no rule claims (`everyoneElse`).

For each rule and for `everyoneElse` you get the campaign's inboxes that can send now, their combined daily
limit, and the contacts that can still get an email and match now. At most 100,000 contacts are read, and a
contact whose provider is still being detected is in no group. `warnings` lists rules with no inbox that
can send (`rule_no_inbox`), contacts left with no inbox (`everyone_else_no_inbox`), and rules that
need more than 5 days to reach their contacts (`rule_slow`). `allInboxes` shows whether the campaign
uses all inboxes or a saved list.

Errors:

- `400 validation_failed`: the workspace does not have the sender routing feature (detail code
`feature_disabled`).
- `404 not_found`: the campaign does not exist in this workspace.

Requires Campaigns view.

[Try it on developer.ken.so](https://developer.ken.so/reference/#kenso-api/tag/campaigns/GET/v1/campaigns/%7BcampaignId%7D/sender-routing)

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `campaignId` | path | integer (int64) | yes | Id of the campaign. |
| `Ken-Version` | header | string, one of: 2026-11-02, 1.1 | no | The API version, a date in `YYYY-MM-DD` form. `1.1` is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and `404` where the path exists only in this version. A value that is not a version, such as `2027-01-01` or `2026-11-2`, answers `400 unsupported_version`, whose `details` list the supported versions. |
| `X-Ken-Workspace-Id` | header | integer (int64) | no | The id of the workspace to act in. Leave it out when your API key reaches only one workspace. When the key reaches more than one, a request without this header answers `400 workspace_required`. A workspace you are not a member of answers `404 not_found`. |

### Response 200

`data` is a `SenderRouting`.

| Field | Type | Description |
| --- | --- | --- |
| `allInboxes` | boolean | True when the campaign uses all inboxes, so inboxes connected later join it. False when it uses a saved list. Change it with `PUT /v1/campaigns/{campaignId}/inboxes`. |
| `rules` | array of SenderRouteRule | The routing rules, sorted by provider name. |
| `everyoneElse` | SenderRouteGroup | The inboxes no rule claims and the contacts no rule matches. |
| `warnings` | array of SenderRoutingWarning | Problems that would make contacts wait. Empty when there are none. |

### Request

```bash
curl -X GET "https://api.ken.so/v1/campaigns/812/sender-routing" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"
```

### Example response

```json
{
  "success": true,
  "data": {
    "allInboxes": false,
    "rules": [
      {
        "provider": {
          "slug": "microsoft_365",
          "name": "Microsoft 365",
          "kind": "mailbox_provider"
        },
        "domains": [
          "outreach.example.net"
        ],
        "inboxIds": [],
        "sendableInboxCount": 2,
        "dailyCapacity": 100,
        "leadCount": 736
      }
    ],
    "everyoneElse": {
      "sendableInboxCount": 4,
      "dailyCapacity": 200,
      "leadCount": 1191
    },
    "warnings": [
      {
        "code": "rule_slow",
        "provider": "microsoft_365",
        "leadCount": 736,
        "days": 8
      }
    ]
  }
}
```

## Types

Each named type the tables above use, nested ones included.

### SenderRouteRule

One routing rule, with the inboxes and contacts it covers now.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `provider` | RecipientProvider | no | The mailbox provider or security gateway the rule matches. |
| `domains` | array of string | no | Whole sending domains, in lower case. Inboxes added on these domains later join the rule. |
| `inboxIds` | array of integer (int64) | no | Ids of single inboxes in the rule. |
| `sendableInboxCount` | integer (int32) | no | The campaign's inboxes in the rule that can send now: they can send through Kenso and are not paused. |
| `dailyCapacity` | integer (int32) | no | Sum of those inboxes' daily send limits, in emails per day. An inbox with no limit set counts as 0. |
| `leadCount` | integer (int32) | no | The campaign's contacts that can still get an email and that the rule matches now. Contacts whose provider is still being detected are in no group. At most 100,000 contacts are counted. |

### SenderRouteGroup

The inboxes no rule claims and the contacts no rule matches.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `sendableInboxCount` | integer (int32) | no | Inboxes in no rule that can send now: they can send through Kenso and are not paused. |
| `dailyCapacity` | integer (int32) | no | Sum of those inboxes' daily send limits, in emails per day. |
| `leadCount` | integer (int32) | no | Contacts that can still get an email and that no rule matches. |

### SenderRoutingWarning

A routing problem that would make contacts wait.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `code` | string | no | The problem. `rule_no_inbox`: none of the rule's inboxes can send, so its contacts wait. `everyone_else_no_inbox`: every inbox that can send is in a rule, so contacts no rule matches wait. `rule_slow`: the rule needs more than 5 days to reach its contacts at its daily capacity. |
| `provider` | string | no | The rule's provider slug. Omitted for `everyone_else_no_inbox`. |
| `leadCount` | integer (int32) | no | Contacts that wait or are slow to reach. |
| `days` | integer (int32) | no | For `rule_slow` only: contacts divided by daily capacity, rounded up, in days. |

### RecipientProvider

A mailbox provider or security gateway Kenso recognizes.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `slug` | string | no | Stable short id, such as `google_workspace`, `microsoft_365` or `mimecast`. |
| `name` | string | no | Display name. |
| `kind` | string | no | Provider type: `mailbox_provider` or `security_gateway`. |
