Delete a subscription
DELETE
/api/v3/contacts/{email}/subscriptions/{channelSlug}
const url = 'https://api.tryletterhead.com/api/v3/contacts/example/subscriptions/example';const options = { method: 'DELETE', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"api":true}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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 }'Removes a contact’s subscription to a single newsletter, identified by {email} and {channelSlug} in the URL. To change a subscription’s status instead of removing it outright, use Update a subscription.
This is a company-level (v3) write. Authenticate with a company API key as a Bearer token.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” email
required
string
The contact’s email address, URL-encoded.
channelSlug
required
string
The newsletter’s channel identifier (slug).
Request Body required
Section titled “Request Body required ” Media type application/json
object
api
Required. Set to true to authenticate with an API key.
boolean
Example
{ "api": true}Responses
Section titled “ Responses ”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": { "subscriptions": [] }, "message": "Subscription removed.", "total": 1}Still can’t find what you need? Contact support.