Delete a subscriber from an account

Article: 000054584

Updated: September 11, 2025

Delete a subscriber from an account

Abstract

Describes the request and response details of this Moosend API endpoint to delete a subscriber from the entire account.

Request

Parameter	In	Type	Required	Description
`Accept`	header	string	true	Determines the expected format and data type to retrieve the response data. Value: `application/json`
`Format`	path	string	true	The supported file format for getting a response. Possible values: `json` and `xml`.
`apikey`	query	string	true	The API key of your account.
`Email`	body	string	true	The email address of the subscriber.
`IncludeAllSubAccounts`	body	boolean	false	Determines whether to delete the subscriber from all subaccounts.

Response

Status	Description	Headers	Schema
`200 OK`	The request is successful.	`Content-Type:application/json`	N/A

Code - the response code. This is 0 if successful.
Error - the response error message. This is null if successful.
- VALIDATION-ERROR - input validation error occurred.
- MEMBER-NOT-FOUND - a specified email address was not found in the email list.
- MEMBER-DELETION-FAILED - failed to delete one or more members.
Context - this is null if successful.

Request

POST https://{hostname}/v3/subscribers/delete.{format}?apikey=
Request body:
{
  "Email": "subscriber@example.com",
  "IncludeAllSubAccounts": true
}

Request

curl --location --globoff --request GET 'https://{hostname}/v3/subscribers/delete.{Format}?apikey=' \
--header 'Content-Type: application/json' \
--data-raw '{
  "Emails": "subscriber@example.com",
  "IncludeAllSubAccounts": true
}'

Response

json

{
  "Code": 0,
  "Error": null,
  "Context": null
}

Choose your product

topic label

topic title

View More

subtopic title

View More

Video Tutorials

subtopic name

article title

QuickStart Guides

title

What's New

Latest Product Updates

Delete a subscriber from an account

Delete a subscriber from an account

Request

Response

Questions?

Give Feedback

Related Answers