Get Remove contact from list action

GET

/smartflows/{smartflowId}/actions/lists/contact-remove/{activityId}

Removes a contact from selected list, enabling segmentation, targeted campaigns or follow-up workflows. Useful for managing subscriptions, automating exclusions, or refining audience targeting.

Request

Path Params

Header Params

Body Params application/json

Examples

Responses

🟠400

application/json

Bad Request

Bodyapplication/json

🟠403

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/smartflows//actions/lists/contact-remove/' \
--header 'Authorization: Bearer JWT' \
--header 'Content-Type: application/json' \
--data '{
    "data": {
        "name": "Custom activity name",
        "activityId": "4a06896c-81b3-44f4-b493-2057bef951a2",
        "smartflowId": "4a06896c-81b3-44f4-b493-2057bef951a2",
        "ancestorId": "4a06896c-81b3-44f4-b493-2057bef951a2",
        "descendantId": "4a06896c-81b3-44f4-b493-2057bef951a2",
        "listIds": [
            123,
            456
        ],
        "metrics": {
            "contactsCount": 123
        }
    }
}'

Response Example

400 - Success

{
    "error": "Reason of failure"
}

Modified at 2026-06-17 23:53:26

Create Add contact to list action

Update Remove contact from list action