Skip to content
Letterhead Letterhead Letterhead Help Center
Admin Tools

Delete a subscription

DELETE
/api/v3/contacts/{email}/subscriptions/{channelSlug}
curl --request DELETE \
--url https://api.tryletterhead.com/api/v3/contacts/example/subscriptions/example \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "api": true }'
email
required
string

The contact’s email address, URL-encoded.

channelSlug
required
string

The newsletter’s channel identifier (slug).

Media type application/json
object
api

Required. Set to true to authenticate with an API key.

boolean
Example
{
"api": true
}

200 OK. Returns the updated contact — same shape as GET /api/v3/contacts/{email}.

Media type application/json
object
items

The contact, with the subscription removed. Full field list under GET /api/v3/contacts/{email}.

object
message
string
total
integer
Example
{
"items": {
"email": "[email protected]",
"subscriptions": []
},
"message": "Subscription removed.",
"total": 1
}

Still can’t find what you need? Contact support.