curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/connections/mail/managed' \
--header "Authorization: Bearer $EDI_API_TOKEN" \
--header 'Content-Type: application/json' \
--data '{
"environment": "string",
"replace_connection_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'
{
"data": {
"active": true,
"environment": "string",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"mail_tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"mailbox_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"mode": "string",
"paused": true,
"pending_deliveries": 1,
"sender": "string",
"service_url": "string",
"tested_at": "2026-08-31T14:22:05Z"
},
"success": true
}
Managed
Managed tenant, mailbox and scoped connection ready; replay returns the original connection
POST
/
v1
/
connections
/
mail
/
managed
curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/connections/mail/managed' \
--header "Authorization: Bearer $EDI_API_TOKEN" \
--header 'Content-Type: application/json' \
--data '{
"environment": "string",
"replace_connection_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'
{
"data": {
"active": true,
"environment": "string",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"mail_tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"mailbox_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"mode": "string",
"paused": true,
"pending_deliveries": 1,
"sender": "string",
"service_url": "string",
"tested_at": "2026-08-31T14:22:05Z"
},
"success": true
}
Request body
ManagedMailInput
string
required
string,null
Explicitly replace this current revision if configuration changed while an earlier provisioning attempt was pending. Omit for ordinary retries.
Response
MailConnectionResponse
MailConnectionView
required
boolean
required
Status codes
| Code | Meaning |
|---|---|
200 | Managed tenant, mailbox and scoped connection ready; replay returns the original connection |
409 | Setup is already running or provider configuration changed |
Using this contract
Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/connections/mail/managed' \
--header "Authorization: Bearer $EDI_API_TOKEN" \
--header 'Content-Type: application/json' \
--data '{
"environment": "string",
"replace_connection_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'
{
"data": {
"active": true,
"environment": "string",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"mail_tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"mailbox_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"mode": "string",
"paused": true,
"pending_deliveries": 1,
"sender": "string",
"service_url": "string",
"tested_at": "2026-08-31T14:22:05Z"
},
"success": true
}
Last modified on October 20, 2026