Sign in
Sending accounts

Test an SMTP sending account

Changed on

Runs a connection test for a custom SMTP account. The shared Amazon SES account and OAuth accounts cannot be tested through this endpoint.

post/providers/{public_id}/test

Request

  • Base URL: https://app.sendmux.ai/api/v1
  • URL: https://app.sendmux.ai/api/v1/providers/{public_id}/test
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.sendmux.ai/oauth/authorize, token URL https://app.sendmux.ai/oauth/token, scopes: provider.update)

Path parameters

public_idstring required

Sending account public ID

Example:dprov_clxxxxxxxxxxxxxxxxxxxxxxxxx

Headers

Idempotency-Keystring

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.

Example:providers-create-20260525-001

Response

Connection test result

oktrue required

Example response

{
  "meta": {
    "request_id": "req_clxxxxxxxxxxxxxxxxxxxxxxxxx"
  },
  "data": {
    "latency_ms": 182,
    "message": "Connection verified.",
    "success": true,
    "tested_at": "2026-05-25T02:18:00Z"
  }
}

Changes