Skip to main content
POST
/
providers
/
{public_id}
/
test
Test an SMTP sending account
curl --request POST \
  --url https://app.sendmux.ai/api/v1/providers/{public_id}/test \
  --header 'Authorization: Bearer <token>'
{
  "ok": true,
  "meta": {
    "request_id": "req_clxxxxxxxxxxxxxxxxxxxxxxxxx"
  },
  "data": {
    "success": true,
    "message": "Connection verified.",
    "latency_ms": 182,
    "tested_at": "2026-05-25T02:18:00Z"
  }
}

Authorizations

​
Authorization
string
header
required

Sendmux API key. Use a root API key for Management API routes, or a mailbox credential for Mailbox API routes. Obtain keys from the dashboard under API Keys.

Headers

​
Idempotency-Key
string

Client-chosen unique key to safely retry the request. Cached for 24h per (team, endpoint, key). Different body with same key returns 409 idempotency_conflict.

Maximum string length: 255
Example:

"providers-create-20260525-001"

Path Parameters

​
public_id
string
required

Sending account public ID

Example:

"dprov_clxxxxxxxxxxxxxxxxxxxxxxxxx"

Response

Connection test result

​
ok
enum<boolean>
required
Available options:
true
​
meta
object
required
​
data
object
required