menu
List mail servers
Lists the account’s connected email servers - the SMTP providers (AWS SES, Gmail, or any SMTP relay) SendStreak delivers through. Credentials are masked; secrets are write-only across the v2 API.
Endpoint
GET https://api.sendstreak.com/v2/accounts/{accountId}/mail-servers
All v2 endpoints require a bearer token - see Authentication.
Path parameters
| Parameter | Type | Description |
|---|---|---|
accountId | string | The account the request is scoped to. |
Query parameters
| Parameter | Type | Description |
|---|---|---|
start | integer | Zero-based offset of the first item to return. Default: 0. |
limit | integer | Maximum number of items to return. Clamped to 100. Default: 25. |
Response
A page of mail servers.
{
"start": 0,
"limit": 25,
"items": [
{
"_id": "665f0a2b1c9d440012ab34cd",
"serviceType": "awsses",
"host": "smtp.example.com",
"port": 587,
"secure": false,
"requireTLS": false,
"user": "smtp-user",
"password": "super-secret-password"
}
]
}
Errors
| Status | Description |
|---|---|
401 | Missing or invalid token, or the token is not authorized for this account/user. |
See Errors and rate limits for what error responses look like.
Curl example
curl --location --request GET 'https://api.sendstreak.com/v2/accounts/YOUR_ACCOUNT_ID/mail-servers' \
--header 'Authorization: Bearer YOUR_API_TOKEN'