Skip to main content
POST
/
marketing-emails
/
v1
/
emails
Create a marketing email
curl --request POST \
  --url https://api.hubapi.com/marketing-emails/v1/emails \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "subject": "<string>"
}
'
{
  "ab": true,
  "abHoursToWait": 123,
  "abTestPercentage": 123,
  "abVariation": true,
  "absoluteUrl": "<string>",
  "allEmailCampaignIds": [
    123
  ],
  "analyticsPageId": "<string>",
  "analyticsPageType": "<string>",
  "archived": true,
  "author": "<string>",
  "authorAt": 123,
  "authorEmail": "<string>",
  "authorName": "<string>",
  "authorUserId": 123,
  "campaign": "<string>",
  "campaignName": "<string>",
  "campaignUtm": "<string>",
  "canSpamSettingsId": 123,
  "categoryId": 123,
  "contentTypeCategory": 123,
  "created": 123,
  "createdById": 123,
  "currentState": "<string>",
  "currentlyPublished": true,
  "domain": "<string>",
  "emailBody": "<string>",
  "emailNote": "<string>",
  "emailTemplateMode": "<string>",
  "emailType": "<string>",
  "emailbodyPlaintext": "<string>",
  "freezeDate": 123,
  "fromName": "<string>",
  "htmlTitle": "<string>",
  "id": 123,
  "isGraymailSuppressionEnabled": true,
  "isLocalTimezoneeSend": true,
  "isPublished": true,
  "isRecipientFatigueSuppressionEnabled": true,
  "lastEditSessionId": 123,
  "lastEditUpdateId": 123,
  "layoutSections": {},
  "leadFlowId": 123,
  "liveDomain": "<string>",
  "mailingListsExcluded": [
    123
  ],
  "mailingListsIncluded": [
    123
  ],
  "maxRssEntries": 123,
  "metaDescription": "<string>",
  "name": "<string>",
  "pageExpiryEnabled": true,
  "pageRedirected": true,
  "portalId": 123,
  "previewKey": "<string>",
  "processingStatus": "<string>",
  "publishDate": 123,
  "publishImmediately": true,
  "publishedUrl": "<string>",
  "replyTo": "<string>",
  "resolvedDomain": "<string>",
  "rssEmailByText": "<string>",
  "rssEmailClickThroughText": "<string>",
  "rssEmailCommentText": "<string>",
  "rssEmailEntryTemplateEnabled": true,
  "rssEmailImageMaxWidth": 123,
  "rssEmailUrl": "<string>",
  "slug": "<string>",
  "smartEmailFields": {},
  "state": "<string>",
  "styleSettings": {},
  "subcategory": "<string>",
  "subject": "<string>",
  "subscription": 123,
  "subscriptionName": "<string>",
  "teamPerms": [
    "<string>"
  ],
  "templatePath": "<string>",
  "transactional": true,
  "unpublishedAt": 123,
  "updated": 123,
  "updatedById": 123,
  "url": "<string>",
  "useRssHeadlineAsSubject": true,
  "userPerms": [
    "<string>"
  ],
  "vidsExcluded": [
    123
  ],
  "vidsIncluded": [
    123
  ],
  "widgets": {}
}
The v1 marketing email API will be sunset on November 1, 2025. If you were previously using this endpoint, check out the newer v3 endpoint instead.

Required Scopes

This API requires one of the following scopes:
  • content

Body

application/json
name
string
required

The name of the email, displayed in the email dashboard

subject
string

The email subject line

Response

Marketing email created successfully

ab
boolean

Whether this is an A/B test email

abHoursToWait
integer

Hours to wait for A/B test

abTestPercentage
integer

Percentage for A/B test

abVariation
boolean

Whether this is an A/B variation

absoluteUrl
string

The absolute URL of the email

allEmailCampaignIds
integer[]

All email campaign IDs associated with this email

analyticsPageId
string

Analytics page ID

analyticsPageType
string

Analytics page type

archived
boolean

Whether the email is archived

author
string

Email author

authorAt
integer<int64>

Timestamp when authored

authorEmail
string

Author's email address

authorName
string

Author's name

authorUserId
integer

Author's user ID

campaign
string

Campaign ID

campaignName
string

Campaign name

campaignUtm
string

Campaign UTM parameter

canSpamSettingsId
integer

CAN-SPAM settings ID

categoryId
integer

Category ID

contentTypeCategory
integer

Content type category

created
integer<int64>

Creation timestamp

createdById
integer

ID of user who created the email

currentState
string

Current state of the email

currentlyPublished
boolean

Whether currently published

domain
string

Domain

emailBody
string

Email body content

emailNote
string

Email note

emailTemplateMode
string

Email template mode

emailType
string

Type of email

emailbodyPlaintext
string

Plain text version of email body

freezeDate
integer<int64>

Freeze date timestamp

fromName
string

From name

htmlTitle
string

HTML title

id
integer

Email ID

isGraymailSuppressionEnabled
boolean

Whether graymail suppression is enabled

isLocalTimezoneeSend
boolean

Whether to send in local timezone

isPublished
boolean

Whether the email is published

isRecipientFatigueSuppressionEnabled
boolean

Whether recipient fatigue suppression is enabled

lastEditSessionId
integer

Last edit session ID

lastEditUpdateId
integer

Last edit update ID

layoutSections
object

Layout sections

leadFlowId
integer

Lead flow ID

liveDomain
string

Live domain

mailingListsExcluded
integer[]

Excluded mailing lists

mailingListsIncluded
integer[]

Included mailing lists

maxRssEntries
integer

Maximum RSS entries

metaDescription
string

Meta description

name
string

Email name

pageExpiryEnabled
boolean

Whether page expiry is enabled

pageRedirected
boolean

Whether page is redirected

portalId
integer

Portal ID

previewKey
string

Preview key

processingStatus
string

Processing status

publishDate
integer<int64>

Publish date timestamp

publishImmediately
boolean

Whether to publish immediately

publishedUrl
string

Published URL

replyTo
string

Reply-to email address

resolvedDomain
string

Resolved domain

rssEmailByText
string

RSS email by text

rssEmailClickThroughText
string

RSS email click through text

rssEmailCommentText
string

RSS email comment text

rssEmailEntryTemplateEnabled
boolean

Whether RSS email entry template is enabled

rssEmailImageMaxWidth
integer

RSS email image max width

rssEmailUrl
string

RSS email URL

slug
string

Email slug

smartEmailFields
object

Smart email fields

state
string

Email state

styleSettings
object

Style settings

subcategory
string

Email subcategory

subject
string

Email subject

subscription
integer

Subscription ID

subscriptionName
string

Subscription name

teamPerms
string[]

Team permissions

templatePath
string

Template path

transactional
boolean

Whether this is a transactional email

unpublishedAt
integer<int64>

Unpublished timestamp

updated
integer<int64>

Last updated timestamp

updatedById
integer

ID of user who last updated the email

url
string

Email URL

useRssHeadlineAsSubject
boolean

Whether to use RSS headline as subject

userPerms
string[]

User permissions

vidsExcluded
integer[]

Excluded video IDs

vidsIncluded
integer[]

Included video IDs

widgets
object

Email widgets

Last modified on October 16, 2025