---
title: "Unpublish or cancel a marketing email"
method: POST
path: "/marketing/emails/2026-03/{emailId}/unpublish"
tags: ["Emails"]
---

# Unpublish or cancel a marketing email

`POST /marketing/emails/2026-03/{emailId}/unpublish`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/marketing/emails/2026-03/{emailId}/unpublish`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `marketing-email`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `transactional-email`

If you have a Marketing Hub Enterprise account or the Transactional Email Add-On, you can use this endpoint to unpublish an automated email or cancel a regular email. If the email is already in the process of being sent, canceling might not be possible.

## Path parameters

- `emailId` string, required

## Response `204`

No content

## Other responses

- `default`: An error occurred.

## Changes

- **2026-11-19** (2026-03) `a2b5d0cf80ab`: 2 info
  - the security scope `marketing-email` was added to the endpoint's security scheme `oauth2`
  - the security scope `transactional-email` was removed from the endpoint's security scheme `oauth2`
- **2026-10-14** (2026-03) `deba4fb9e606`: 2 info
  - the security scope `marketing-email` was added to the endpoint's security scheme `oauth2`
  - the security scope `transactional-email` was removed from the endpoint's security scheme `oauth2`
- **2026-10-10** (2026-03) `cb72368b037e`: 2 info
  - the security scope `marketing-email` was added to the endpoint's security scheme `oauth2`
  - the security scope `transactional-email` was removed from the endpoint's security scheme `oauth2`
- **2026-10-01** (2026-03) `cb72368b037e`: 2 info
  - the security scope `marketing-email` was added to the endpoint's security scheme `oauth2`
  - the security scope `transactional-email` was removed from the endpoint's security scheme `oauth2`
- **2026-09-29** (2026-03) `acb0e86b6c96`: 2 info
  - the security scope `marketing-email` was added to the endpoint's security scheme `oauth2`
  - the security scope `transactional-email` was removed from the endpoint's security scheme `oauth2`

[Operation history](https://skmtc.dev/hubspot/apis/marketing-marketing-emails/changes/marketing/emails/2026-03/:emailId/unpublish/post.md)

---

[API](https://skmtc.dev/hubspot/apis/marketing-marketing-emails.md) - [All operations](https://skmtc.dev/hubspot/apis/marketing-marketing-emails/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/marketing-marketing-emails/revisions/a2b5d0cf80ab?raw)
