Update a connection's settings

Partial update (JSON merge-patch — omitted fields are left unchanged) of a connection's cleansing settings. Body may set any of: manual_mode (boolean; mode-independent), autofloss / decay_protection (paid-plan booleans — 403 on the free tier), subject to connector capabilities. Attentive does not support Autofloss, Decay Protection, delete or tag actions; unsupported settings return 422 after applicable plan checks. aggressiveness (normal/aggressive cascade canonical values to all 12 check gates, custom detaches from a preset without changing gates), and checks (a partial map of the 12 gates — editing ANY gate switches aggressiveness to custom). aggressiveness and checks are mutually exclusive in one request (editing checks already implies custom) → 400 if both are sent. At least one field is required. Returns 200 with the refreshed connection (same shape as the GET). A connection id that does not exist or belongs to another org → 404. PATCH is idempotent; it does not consume the Idempotency-Key header.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

curl --location --request PATCH 'https://api.mailfloss.com/v1/integrations//connections/' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "manual_mode": true, "aggressiveness": "normal", "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": true }, "autofloss": true, "decay_protection": true, "action": "unsubscribe" }'

{ "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 } }

Update a connection's settings

Request

Responses