---
title: "List sender connections"
method: GET
path: "/mailmerge/connections"
tags: ["Mail merge"]
---

# List sender connections

`GET /mailmerge/connections`

## Request

- Base URL: `https://api.podpdf.com`
- URL: `https://api.podpdf.com/mailmerge/connections`
- Auth: API key in header `X-API-Key`

The mail servers campaigns can send through. Connections are created, changed and tested
in the dashboard; the password is never returned.

## Response `200`

The account's connections

- object
  - `connections` MailConnection[]
    - `connection_id` string
    - `provider` 'smtp'
    - `label` string, nullable
    - `from_email` string, email
    - `from_name` string, nullable
    - `reply_to` string, email, nullable
    - `smtp` object
      - `host` string
      - `port` 465 | 587 | 2525
      - `security` 'tls' | 'starttls'
      - `username` string
    - `max_parallel` integer
    - `max_per_minute` integer, nullable
    - `status` 'unverified' | 'verified' | 'failing': Campaigns need `verified`, which a successful test email sets.
    - `has_secret` boolean
    - `secret_hint` string
    - `verified_at` string, date-time, nullable
    - `last_error` string, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `count` integer
  - `max_connections` integer

## Other responses

- `401`: Missing or invalid API key
- `403`: `INSUFFICIENT_CREDITS`, `CONVERSION_TYPE_NOT_ENABLED`, `PDF_TOOLS_NOT_ENABLED`, `RATE_LIMIT_EXCEEDED` or `ACCOUNT_NOT_FOUND`. Note that a plan's rate limit is a 403, not a 429.

---

[API](https://skmtc.dev/podpdf/apis/podpdf-api.md) · [All operations](https://skmtc.dev/podpdf/apis/podpdf-api/llms.txt) · [OpenAPI document](https://skmtc.dev/podpdf/apis/podpdf-api/revisions/84eb21f3ee27?raw)