Read one integration with all of its connections
GET
/v1/integrations/{type}
type, connected, connection_count) plus the full connections[] array for the integration type. (org, type) is 1:N: a customer can connect multiple accounts of the same ESP (e.g. two Mailchimp accounts for different brands); each entry in connections[] is one connection with its own stable id, customer-set name, status, and per-connection settings. Connections are ordered by createdAt asc (oldest first); connections[0] matches the primary returned by the LIST endpoint. When the org has no active connections for this type, connected: false + connection_count: 0 + connections: [] — the response shape stays symmetric so chatbots don't need try/catch on 404 to ask "is X connected?". Unknown type (not in the closed ESP enum, including hidden internal types like csv/api/input/zapier) → 404 not_found.Request
Path Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.mailfloss.com/v1/integrations/' \
--header 'Authorization: Bearer <token>'Response Response Example
200 - Success
{
"type": "mailchimp",
"connected": true,
"connection_count": 1,
"connections": [
{
"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
}
}
],
"disconnected_connections": [
{
"id": "conn_4c3b2a1e0f9z8y",
"name": "Old Account",
"status": "disconnected",
"created_at": "2025-11-05T09:15:00Z",
"disconnected_at": "2026-05-22T16:45:00Z"
}
]
}Modified at 2026-10-20 13:54:45