Unsubscribe a subscriber from a mailing list

POST /subscribers/{MailingListID}/unsubscribe.{Format}

Unsubscribes a subscriber from a specific email list in your Sitecore Send 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
MailingListID	path	string	true	The ID of the email list from which you want to unsubscribe a subscriber.
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.

http

POST https://{hostname}/v3/subscribers/{MailingListID}/unsubscribe.{Format}?apikey=

Request body:
{
  "Email": "[email protected]"
}

curl

curl --include \\
     --request POST \\
     --header "Content-Type: application/json" \\
     --header "Accept: application/json" \\
     --data-raw '{
    "Email": "[email protected]"
}' \\
'https://{hostname}/v3/subscribers/{MailingListID}/unsubscribe.{Format}?apikey='

Response

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

json

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

Code - the response code. This is 0 if successful.
Error - the response error message. This is null if successful.
Context - this is null if successful.

If you have suggestions for improving this article, let us know!