Delete a segment

Article: 000054616

Updated: September 11, 2025

Abstract

Describes the request and response details of this Moosend API endpoint to delete a segment in a mailing list.

Parameter	In	Type	Required	Description
`MailingListID`	path	string	true	The ID of the email list that contains the segment.
`SegmentID`	path	string	true	The ID of the segment to be deleted.
`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.

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

Status

Description

Headers

Schema

200 OK

The request is successful.

Content-Type:application/json

Accept:application/json

N/A

Request

DELETE https://{hostname}/v3/lists/{MailingListID}/segments/{SegmentID}/delete.{Format}?apikey=

Request

curl --include \
     --request DELETE \
'https://{hostname}/v3/lists/{MailingListID}/segments/{SegmentID}/delete.{Format}?apikey='

Response

json

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

topic title