---
title: "Remove subscriber from workflow"
method: POST
path: "/3.0/automations/{workflow_id}/removed-subscribers"
tags: ["automations"]
---

# Remove subscriber from workflow

`POST /3.0/automations/{workflow_id}/removed-subscribers`

## Request

- Base URL: `https://api.mailchimp.com`
- URL: `https://api.mailchimp.com/3.0/automations/{workflow_id}/removed-subscribers`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://login.mailchimp.com/oauth2/authorize`
    - Token URL: `https://login.mailchimp.com/oauth2/token`
- TypeScript: <https://skmtc.dev/mailchimp/apis/mailchimp-api/docs/3.0/automations/:workflow_id/removed-subscribers/post.ts> (a function with typed inputs; its response is checked against the schema)

Remove a subscriber from a specific classic automation workflow. You can remove a subscriber at any point in an automation workflow, regardless of how many emails they've been sent from that workflow. Once they're removed, they can never be added back to the same workflow.

## Path parameters

- `workflow_id` string, required

## Request body

- object: Information about subscribers in an Automation email queue.
  - `email_address` string, required: The list member's email address.

## Response `200`

- object: A summary of a subscriber removed from an Automation workflow.
  - `_links` array[]: A list of link types and descriptions for the API schema documents.
    - object[]: A list of link types and descriptions for the API schema documents.
      - `href` string: This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action.
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD': The HTTP method that should be used when accessing the URL defined in 'href'.
      - `rel` string: As with an HTML 'rel' attribute, this describes the type of link.
      - `schema` string: For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to.
      - `targetSchema` string: For GETs, this is a URL representing the schema that the response should conform to.
  - `email_address` string: The list member's email address.
  - `id` string: The MD5 hash of the lowercase version of the list member's email address.
  - `list_id` string: A string that uniquely identifies a list.
  - `workflow_id` string: A string that uniquely identifies an Automation workflow.

## Other responses

- `default`: An error generated by the Mailchimp API.

---

[API](https://skmtc.dev/mailchimp/apis/mailchimp-api.md) - [All operations](https://skmtc.dev/mailchimp/apis/mailchimp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mailchimp/apis/mailchimp-api/revisions/53bf4b156855?raw)