Skip to main content
PATCH
/
providers
/
{public_id}
Update a sending account
curl --request PATCH \
  --url https://app.sendmux.ai/api/v1/providers/{public_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "meta": {
    "request_id": "req_clxxxxxxxxxxxxxxxxxxxxxxxxx"
  },
  "data": {
    "id": "dprov_clxxxxxxxxxxxxxxxxxxxxxxxxx",
    "name": "Transactional SMTP",
    "type": "smtp",
    "status": "active",
    "status_reason": "<string>",
    "is_active": true,
    "is_shared": true,
    "is_editable": true,
    "allowed_actions": {
      "update": true,
      "delete": true,
      "activate": true,
      "deactivate": true,
      "test": true
    },
    "smtp_host": "<string>",
    "smtp_port": 123,
    "smtp_protocol": "<string>",
    "smtp_username": "<string>",
    "has_smtp_password": true,
    "from_email": "<string>",
    "from_name": "<string>",
    "reply_to_email": "<string>",
    "reply_to_name": "<string>",
    "oauth_email": "<string>",
    "has_refresh_token": true,
    "quotas": {
      "per_second": {
        "min": 60,
        "max": 60
      },
      "per_minute": {
        "min": 60,
        "max": 60
      },
      "per_hour": {
        "min": 60,
        "max": 60
      },
      "per_day": {
        "min": 60,
        "max": 60
      }
    },
    "percentage": 100,
    "tracking_domain": "<string>",
    "created_at": "2026-05-25T02:18:00Z",
    "updated_at": "2026-05-25T02:18:00Z",
    "last_tested_at": "<string>",
    "last_used_at": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.sendmux.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
If-Match
string

Weak ETag from a prior GET. Reject with 409 conflict when the server's current ETag differs.

Path Parameters

​
public_id
string
required

Sending account public ID

Example:

"dprov_clxxxxxxxxxxxxxxxxxxxxxxxxx"

Body

application/json
​
name
string
Required string length: 1 - 255
Example:

"Transactional SMTP"

​
smtp_host
string
Required string length: 1 - 255
Example:

"smtp.example.com"

​
smtp_port
integer
Required range: 1 <= x <= 65535
Example:

587

​
smtp_protocol
enum<string>
Available options:
tls,
ssl,
none,
starttls
Example:

"starttls"

​
smtp_username
string
Required string length: 1 - 255
Example:

"api-user"

​
from_email
string<email> | null
Maximum string length: 255
Example:

"sender@example.com"

​
from_name
string | null
Maximum string length: 255
Example:

"Acme"

​
reply_to_email
string<email> | null
Maximum string length: 255
Example:

"support@example.com"

​
reply_to_name
string | null
Maximum string length: 255
Example:

"Support"

​
quotas
object
​
percentage
integer
Required range: 0 <= x <= 100
Example:

100

​
tracking_domain
string | null
Maximum string length: 255
Example:

"click.example.com"

​
smtp_password
string
Required string length: 1 - 500
Example:

"new-smtp-password"

Response

Updated sending account

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