Read one connection

GET

/v1/integrations/{type}/connections/{id}

Returns a single connection by id — the same per-connection shape as one entry of GET /v1/integrations/{type}'s connections[] (stable id, name, status, created_at, last_synced_at, the universal settings object, and the optional per-type extension). A connection id that does not exist or belongs to another org → 404 not_found.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200

application/json

Connection detail

Bodyapplication/json

🟠401

🟠403

🟠404

🟠429

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.mailfloss.com/v1/integrations//connections/' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "id": "conn_5d4c3b2a1e0f9z",
    "name": "Main Marketing List",
    "status": "active",
    "created_at": "2026-02-10T14:20:00Z",
    "last_synced_at": null,
    "settings": {
        "aggressiveness": "normal",
        "manual_mode": false,
        "autofloss": true,
        "decay_protection": true,
        "instafloss": false,
        "action": "unsubscribe",
        "checks": {
            "disposable": true,
            "nonexistent": true,
            "deactivated": true,
            "inbox_full": true,
            "bounced": true,
            "banned_words": true,
            "role_based": true,
            "complainers": true,
            "spam": true,
            "failed_exchange": true,
            "unverified": true,
            "accept_all": false
        },
        "blacklist_count": 5,
        "whitelist_count": 2
    }
}

Modified at 2026-10-20 13:54:45

Connect a new connection (with credentials)

Update a connection's settings