Create configuration set
POST /api/v1/partner/email/configuration-setsRequest body
{
"name": "production",
"description": "Production transactional sends",
"customer_id": "cust_550e8400-...",
"sending_enabled": true,
"reputation_tracking_enabled": true,
"suppression_options": "BOUNCE_AND_COMPLAINT",
"tags": { "env": "prod", "team": "platform" }
}| Field | Type | Required | Notes |
|---|---|---|---|
name | string | yes | Unique per partner, alphanumeric + _ -, 1-256 chars |
description | string | no | |
customer_id | uuid | no | Downstream end-customer attribution |
sending_enabled | bool | no | Default true |
reputation_tracking_enabled | bool | no | Default true |
suppression_options | string | no | NONE / BOUNCE / COMPLAINT / BOUNCE_AND_COMPLAINT (default) |
custom_redirect_domain | string | no | Per-config-set click-tracking host |
tags | object | no | Arbitrary key-value pairs surfaced on mail.tags in webhooks |
Response
{
"success": true,
"configuration_set": {
"config_set_id": "cs_550e8400-...",
"name": "production",
...
}
}Common errors
| Status | Code | Meaning |
|---|---|---|
| 409 | CONFIG_SET_NAME_TAKEN | Another set with that name exists |
| 400 | INVALID_REQUEST | Bad suppression_options value or missing name |