Share via


HubSpot Marketing V2 (Independent Publisher) (Preview)

Marketing software that enables you to drive revenue, save time and resources, and measure and optimize your investments. All on one easy-to-use platform. Drive revenue by connecting with leads at the right time and place across email, landing pages, forms, and more. Manage your contacts and campaigns in one place and use automation tools to scale your efficiency. Measure the success of your campaigns using powerful reporting tools.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Troy Taylor
URL https://www.hitachisolutions.com
Email ttaylor@hitachisolutions.com
Connector Metadata
Publisher Troy Taylor
Website https://www.hubspot.com/products/marketing
Privacy policy https://legal.hubspot.com/privacy-policy
Categories Marketing

HubSpot Marketing V2

Marketing software that enables you to drive revenue, save time and resources, and measure and optimize your investments. All on one easy-to-use platform. Drive revenue by connecting with leads at the right time and place across email, landing pages, forms, and more. Manage your contacts and campaigns in one place and use automation tools to scale your efficiency. Measure the success of your campaigns using powerful reporting tools.

Publisher: Troy Taylor, Hitachi Solutions

Prerequisites

You must have an account with HubSpot and be a Super Admin.

Obtaining Credentials

Once you are logged in to your account, go to Settings -> Account Setup -> Integrations -> Private Apps. You will need to create a private app and assign it only the scopes you will use actions for. Once your private app is created, you will have an access token in the Auth section of the private app.

Supported Operations

Send email

Asynchronously send a transactional email. Returns the status of the email send with a status identifier that can be used to continuously query for the status using the Email Send Status.

Subscribe contact

Subscribes a contact to the given subscription type. This action is not valid to use for subscribing a contact at a brand or portal level and will return an error.

Unsubscribe contact

Unsubscribes a contact from the given subscription type. This action is not valid to use for unsubscribing a contact at a brand or portal level and will return an error.

Get contact subscription statuses

Returns a list of subscriptions and their status for a given contact.

Create bulk communication preferences

Creates a bulk communication preferences request. This request will return a status identifier that can be used to continuously query for the status using the Bulk Communication Preferences Status.

Get subscription definitions

Retrieves a list of all subscription definitions for the portal.

Get aggregated statistics

Retrieves aggregated statistics of emails sent in a specified time span. It also returns the list of emails that were sent during the time span.

Get aggregated statistic intervals

Retrieves aggregated statistics in intervals for a specified time span. Each interval contains aggregated statistics of the emails that were sent in that time.

Get AB marketing email variation

Retrieves the variation of an A/B marketing email. If the email is variation A (master) it will return variation B (variant) and vice versa.

Reset draft

Resets the draft back to a copy of the live object.

Restore draft marketing email

Restores a previous revision of a marketing email to DRAFT state. If there is currently something in the draft for that object, it is overwritten.

Get marketing email draft

Retrieves the draft version of an email (if it exists). If no draft version exists, the published email is returned.

Create or update draft email

Creates or updates the draft version of a marketing email. If no draft exists, the system creates a draft from the current “live” email then applies the request body to that draft. The draft version only lives on the buffer—the email is not cloned.

Get marketing email revisions

Retrieves a list of all versions of a marketing email, with each entry including the full state of that particular version. The current revision has the ID -1.

Get a revision of a marketing email

Retrieves a specific revision of a marketing email.

Create AB test marketing email

Creates a variation of a marketing email for an A/B test. The new variation will be created as a draft. If an active variation already exists, a new one won't be created.

Get marketing emails

Retrieve a list of all marketing emails. The results can be filtered, allowing you to find a specific set of emails.

Create marketing email

Creates a new marketing email.

Restore marketing email revision

Restores a previous revision of a marketing email. The current revision becomes old, and the restored revision is given a new version number.

Clone marketing email

Creates a duplicate email with the same properties as the original, with the exception of a unique identifier.

Get marketing email

Retrieves the details for a marketing email.

Delete marketing email

Deletes a marketing email.

Update marketing email

Change properties of a marketing email.

Create SMTP token

Creates a SMTP token.

Query SMTP tokens

Queries multiple SMTP tokens by campaign name or a single token by email campaign identifier.

Delete token

Deletes a single token by identifier.

Query token

Queries a single token by identifier.

Reset token password

Allows the creation of a replacement password for a given token. Once the password is successfully reset, the old password for the token will be invalid.

Known Issues and Limitations

There are no known issues at this time.

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
Access Token (in the form 'Bearer YOUR_ACCESS_TOKEN') securestring The Access Token (in the form 'Bearer YOUR_ACCESS_TOKEN') for this api True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Clone marketing email

Creates a duplicate email with the same properties as the original, with the exception of a unique identifier.

Create AB test marketing email

Creates a variation of a marketing email for an A/B test. The new variation will be created as a draft. If an active variation already exists, a new one won't be created.

Create bulk communication preferences

Creates a bulk communication preferences request. This request will return a status identifier that can be used to continuously query for the status using the Bulk Communication Preferences Status.

Create marketing email

Creates a new marketing email.

Create or update draft email

Creates or updates the draft version of a marketing email. If no draft exists, the system creates a draft from the current “live” email then applies the request body to that draft. The draft version only lives on the buffer—the email is not cloned.

Create SMTP token

Creates a SMTP token.

Delete marketing email

Deletes a marketing email.

Delete token

Deletes a single token by identifier.

Get a revision of a marketing email

Retrieves a specific revision of a marketing email.

Get AB marketing email variation

Retrieves the variation of an A/B marketing email. If the email is variation A (master) it will return variation B (variant) and vice versa.

Get aggregated statistic intervals

Retrieves aggregated statistics in intervals for a specified time span. Each interval contains aggregated statistics of the emails that were sent in that time.

Get aggregated statistics

Retrieves aggregated statistics of emails sent in a specified time span. It also returns the list of emails that were sent during the time span.

Get contact subscription statuses

Returns a list of subscriptions and their status for a given contact.

Get marketing email

Retrieves the details for a marketing email.

Get marketing email draft

Retrieves the draft version of an email (if it exists). If no draft version exists, the published email is returned.

Get marketing email revisions

Retrieves a list of all versions of a marketing email, with each entry including the full state of that particular version. The current revision has the ID -1.

Get marketing emails

Retrieve a list of all marketing emails. The results can be filtered, allowing you to find a specific set of emails.

Get subscription definitions

Retrieves a list of all subscription definitions for the portal.

Query SMTP tokens

Queries multiple SMTP tokens by campaign name or a single token by email campaign identifier.

Query token

Queries a single token by identifier.

Reset Draft

Resets the draft back to a copy of the live object.

Reset token password

Allows the creation of a replacement password for a given token. Once the password is successfully reset, the old password for the token will be invalid.

Restore draft marketing email

Restores a previous revision of a marketing email to DRAFT state. If there is currently something in the draft for that object, it is overwritten.

Restore marketing email revision

Restores a previous revision of a marketing email. The current revision becomes old, and the restored revision is given a new version number.

Send email

Asynchronously send a transactional email. Returns the status of the email send with a status identifier that can be used to continuously query for the status using the Email Send Status.

Subscribe contact

Subscribes a contact to the given subscription type. This action is not valid to use for subscribing a contact at a brand or portal level and will return an error.

Unsubscribe contact

Unsubscribes a contact from the given subscription type. This action is not valid to use for unsubscribing a contact at a brand or portal level and will return an error.

Update marketing email

Change properties of a marketing email.

Clone marketing email

Creates a duplicate email with the same properties as the original, with the exception of a unique identifier.

Parameters

Name Key Required Type Description
Email ID
emailId True string

The email identifier.

Name
name string

The name.

Returns

Name Path Type Description
Template Path
content.templatePath string

The template path.

Plain Text Version
content.plainTextVersion string

The plain text version.

From
from.fromName string

The from name.

Reply To
from.replyTo string

The reply to.

Custom Reply To
from.customReplyTo string

The custom reply to.

ID
id string

The identifier.

Name
name string

The name.

Send On Publish
sendOnPublish boolean

Whether to send on publish.

State
state string

The state.

Subcategory
subcategory string

The subcategory.

Subject
subject string

The subject.

Include
to.contactLists.include array of string

The include array.

Exclude
to.contactLists.exclude array of string

The exclude array.

Include
to.contactIds.include array of string

The include array.

Exclude
to.contactIds.exclude array of string

The exclude array.

Limit Send Frequency
to.limitSendFrequency boolean

Whether to limit send frequency.

Suppress Graymail
to.suppressGraymail boolean

Whether to suppress graymail.

Created By ID
createdById string

The created by identifier.

Type
type string

The type.

Active Domain
activeDomain string

The active domain.

Archived
archived boolean

Whether archived.

Folder ID
folderId string

The folder identifier.

Feedback Survey ID
feedbackSurveyId string

The feedback survey identifier.

Test ID
testing.testId string

The test identifier.

Hours To Wait
testing.hoursToWait integer

The hours to wait.

AB Success Metric
testing.abSuccessMetric string

The A/B success metric.

AB Sample Size Default
testing.abSampleSizeDefault string

The A/B sample size default.

AB Status
testing.abStatus string

The A/B status.

AB Test Percentage
testing.abTestPercentage string

The A/B test percentage.

AB Sampling Default
testing.abSamplingDefault string

The A/B sampling default.

Subscription ID
subscriptionDetails.subscriptionId string

The subscription identifier.

Preferences Group ID
subscriptionDetails.preferencesGroupId string

The preferences group identifier.

Office Location ID
subscriptionDetails.officeLocationId string

The office location identifier.

Updated By ID
updatedById string

The updated by identifier.

Published By ID
publishedById string

The published by identifier.

Language
language string

The langauge.

Campaign
campaign string

The campaign.

Slug
webversion.slug string

The slug.

Domain
webversion.domain string

The domain.

Title
webversion.title string

The title.

Meta Description
webversion.metaDescription string

The meta description.

Redirect To URL
webversion.redirectToUrl string

The redirect to URL address.

Redirect To Page ID
webversion.redirectToPageId string

The redirect to page identifier.

Expires At
webversion.expiresAt string

When expires at.

Max Entries
rssData.maxEntries string

The max entries.

URL
rssData.url string

The URL address.

HubSpot Blog ID
rssData.hubspotBlogId string

The HubSpot blog identifier.

Blog Email Type
rssData.blogEmailType string

The blog email type.

Blog Image Max Width
rssData.blogImageMaxWidth string

The blog image max width.

Entry Template
rssData.rssEntryTemplate string

The entry template.

Use Headline As Subject
rssData.useHeadlineAsSubject boolean

Whether to use headline as subject.

Blog Layout
rssData.blogLayout string

The blog layout.

Is Transactional
isTransactional boolean

Whether is transactional.

Is Published
isPublished boolean

Whether is published.

Published Date
publishDate string

The published date.

Updated At
updatedAt string

When updated at.

Created At
createdAt string

When created at.

Deleted At
deletedAt string

When deleted at.

Published At
publishedAt string

The published at.

Create AB test marketing email

Creates a variation of a marketing email for an A/B test. The new variation will be created as a draft. If an active variation already exists, a new one won't be created.

Parameters

Name Key Required Type Description
Email ID
emailId True string

The email identifier.

Content ID
contentId string

The content identifier.

Variation Name
variationName string

The variation name.

Returns

Name Path Type Description
Template Path
content.templatePath string

The template path.

Plain Text Version
content.plainTextVersion string

The plain text version.

From
from.fromName string

The from name.

Reply To
from.replyTo string

The reply to.

Custom Reply To
from.customReplyTo string

The custom reply to.

ID
id string

The identifier.

Name
name string

The name.

Send On Publish
sendOnPublish boolean

Whether to send on publish.

State
state string

The state.

Subcategory
subcategory string

The subcategory.

Subject
subject string

The subject.

Include
to.contactLists.include array of string

The include array.

Exclude
to.contactLists.exclude array of string

The exclude array.

Include
to.contactIds.include array of string

The include array.

Exclude
to.contactIds.exclude array of string

The exclude array.

Limit Send Frequency
to.limitSendFrequency boolean

Whether to limit send frequency.

Suppress Graymail
to.suppressGraymail boolean

Whether to suppress graymail.

Created By ID
createdById string

The created by identifier.

Type
type string

The type.

Active Domain
activeDomain string

The active domain.

Archived
archived boolean

Whether archived.

Folder ID
folderId string

The folder identifier.

Feedback Survey ID
feedbackSurveyId string

The feedback survey identifier.

Test ID
testing.testId string

The test identifier.

Hours To Wait
testing.hoursToWait integer

The hours to wait.

AB Success Metric
testing.abSuccessMetric string

The A/B success metric.

AB Sample Size Default
testing.abSampleSizeDefault string

The A/B sample size default.

AB Status
testing.abStatus string

The A/B status.

AB Test Percentage
testing.abTestPercentage string

The A/B test percentage.

AB Sampling Default
testing.abSamplingDefault string

The A/B sampling default.

Subscription ID
subscriptionDetails.subscriptionId string

The subscription identifier.

Preferences Group ID
subscriptionDetails.preferencesGroupId string

The preferences group identifier.

Office Location ID
subscriptionDetails.officeLocationId string

The office location identifier.

Updated By ID
updatedById string

The updated by identifier.

Published By ID
publishedById string

The published by identifier.

Language
language string

The langauge.

Campaign
campaign string

The campaign.

Slug
webversion.slug string

The slug.

Domain
webversion.domain string

The domain.

Title
webversion.title string

The title.

Meta Description
webversion.metaDescription string

The meta description.

Redirect To URL
webversion.redirectToUrl string

The redirect to URL address.

Redirect To Page ID
webversion.redirectToPageId string

The redirect to page identifier.

Expires At
webversion.expiresAt string

When expires at.

Max Entries
rssData.maxEntries string

The max entries.

URL
rssData.url string

The URL address.

HubSpot Blog ID
rssData.hubspotBlogId string

The HubSpot blog identifier.

Blog Email Type
rssData.blogEmailType string

The blog email type.

Blog Image Max Width
rssData.blogImageMaxWidth string

The blog image max width.

Entry Template
rssData.rssEntryTemplate string

The entry template.

Use Headline As Subject
rssData.useHeadlineAsSubject boolean

Whether to use headline as subject.

Blog Layout
rssData.blogLayout string

The blog layout.

Is Transactional
isTransactional boolean

Whether is transactional.

Is Published
isPublished boolean

Whether is published.

Published Date
publishDate string

The published date.

Updated At
updatedAt string

When updated at.

Created At
createdAt string

When created at.

Deleted At
deletedAt string

When deleted at.

Published At
publishedAt string

The published at.

Create bulk communication preferences

Creates a bulk communication preferences request. This request will return a status identifier that can be used to continuously query for the status using the Bulk Communication Preferences Status.

Parameters

Name Key Required Type Description
body
body True array of string

Returns

Create marketing email

Creates a new marketing email.

Parameters

Name Key Required Type Description
Template Path
templatePath string

The template path.

Plain Text Version
plainTextVersion string

The plain text version.

From
fromName string

The from name.

Reply To
replyTo string

The reply to.

Custom Reply To
customReplyTo string

The custom reply to.

ID
id string

The identifier.

Name
name string

The name.

Send On Publish
sendOnPublish boolean

Whether to send on publish.

State
state string

The state.

Subcategory
subcategory string

The subcategory.

Subject
subject string

The subject.

Include
include array of string

The include array.

Exclude
exclude array of string

The exclude array.

Include
include array of string

The include array.

Exclude
exclude array of string

The exclude array.

Limit Send Frequency
limitSendFrequency boolean

Whether to limit send frequency.

Suppress Graymail
suppressGraymail boolean

Whether to suppress graymail.

Created By ID
createdById string

The created by identifier.

Type
type string

The type.

Active Domain
activeDomain string

The active domain.

Archived
archived boolean

Whether archived.

Folder ID
folderId string

The folder identifier.

Feedback Survey ID
feedbackSurveyId string

The feedback survey identifier.

Test ID
testId string

The test identifier.

Hours To Wait
hoursToWait integer

The hours to wait.

AB Success Metric
abSuccessMetric string

The A/B success metric.

AB Sample Size Default
abSampleSizeDefault string

The A/B sample size default.

AB Status
abStatus string

The A/B status.

AB Test Percentage
abTestPercentage string

The A/B test percentage.

AB Sampling Default
abSamplingDefault string

The A/B sampling default.

Subscription ID
subscriptionId string

The subscription identifier.

Preferences Group ID
preferencesGroupId string

The preferences group identifier.

Office Location ID
officeLocationId string

The office location identifier.

Updated By ID
updatedById string

The updated by identifier.

Published By ID
publishedById string

The published by identifier.

Language
language string

The langauge.

Campaign
campaign string

The campaign.

Slug
slug string

The slug.

Domain
domain string

The domain.

Title
title string

The title.

Meta Description
metaDescription string

The meta description.

Redirect To URL
redirectToUrl string

The redirect to URL address.

Redirect To Page ID
redirectToPageId string

The redirect to page identifier.

Expires At
expiresAt string

When expires at.

Max Entries
maxEntries string

The max entries.

URL
url string

The URL address.

HubSpot Blog ID
hubspotBlogId string

The HubSpot blog identifier.

Blog Email Type
blogEmailType string

The blog email type.

Blog Image Max Width
blogImageMaxWidth string

The blog image max width.

Entry Template
rssEntryTemplate string

The entry template.

Use Headline As Subject
useHeadlineAsSubject boolean

Whether to use headline as subject.

Blog Layout
blogLayout string

The blog layout.

Is Transactional
isTransactional boolean

Whether is transactional.

Is Published
isPublished boolean

Whether is published.

Published Date
publishDate string

The published date.

Updated At
updatedAt string

When updated at.

Created At
createdAt string

When created at.

Deleted At
deletedAt string

When deleted at.

Published At
publishedAt string

The published at.

Returns

Name Path Type Description
Template Path
content.templatePath string

The template path.

Plain Text Version
content.plainTextVersion string

The plain text version.

From
from.fromName string

The from name.

Reply To
from.replyTo string

The reply to.

Custom Reply To
from.customReplyTo string

The custom reply to.

ID
id string

The identifier.

Name
name string

The name.

Send On Publish
sendOnPublish boolean

Whether to send on publish.

State
state string

The state.

Subcategory
subcategory string

The subcategory.

Subject
subject string

The subject.

Include
to.contactLists.include array of string

The include array.

Exclude
to.contactLists.exclude array of string

The exclude array.

Include
to.contactIds.include array of string

The include array.

Exclude
to.contactIds.exclude array of string

The exclude array.

Limit Send Frequency
to.limitSendFrequency boolean

Whether to limit send frequency.

Suppress Graymail
to.suppressGraymail boolean

Whether to suppress graymail.

Created By ID
createdById string

The created by identifier.

Type
type string

The type.

Active Domain
activeDomain string

The active domain.

Archived
archived boolean

Whether archived.

Folder ID
folderId string

The folder identifier.

Feedback Survey ID
feedbackSurveyId string

The feedback survey identifier.

Test ID
testing.testId string

The test identifier.

Hours To Wait
testing.hoursToWait integer

The hours to wait.

AB Success Metric
testing.abSuccessMetric string

The A/B success metric.

AB Sample Size Default
testing.abSampleSizeDefault string

The A/B sample size default.

AB Status
testing.abStatus string

The A/B status.

AB Test Percentage
testing.abTestPercentage string

The A/B test percentage.

AB Sampling Default
testing.abSamplingDefault string

The A/B sampling default.

Subscription ID
subscriptionDetails.subscriptionId string

The subscription identifier.

Preferences Group ID
subscriptionDetails.preferencesGroupId string

The preferences group identifier.

Office Location ID
subscriptionDetails.officeLocationId string

The office location identifier.

Updated By ID
updatedById string

The updated by identifier.

Published By ID
publishedById string

The published by identifier.

Language
language string

The langauge.

Campaign
campaign string

The campaign.

Slug
webversion.slug string

The slug.

Domain
webversion.domain string

The domain.

Title
webversion.title string

The title.

Meta Description
webversion.metaDescription string

The meta description.

Redirect To URL
webversion.redirectToUrl string

The redirect to URL address.

Redirect To Page ID
webversion.redirectToPageId string

The redirect to page identifier.

Expires At
webversion.expiresAt string

When expires at.

Max Entries
rssData.maxEntries string

The max entries.

URL
rssData.url string

The URL address.

HubSpot Blog ID
rssData.hubspotBlogId string

The HubSpot blog identifier.

Blog Email Type
rssData.blogEmailType string

The blog email type.

Blog Image Max Width
rssData.blogImageMaxWidth string

The blog image max width.

Entry Template
rssData.rssEntryTemplate string

The entry template.

Use Headline As Subject
rssData.useHeadlineAsSubject boolean

Whether to use headline as subject.

Blog Layout
rssData.blogLayout string

The blog layout.

Is Transactional
isTransactional boolean

Whether is transactional.

Is Published
isPublished boolean

Whether is published.

Published Date
publishDate string

The published date.

Updated At
updatedAt string

When updated at.

Created At
createdAt string

When created at.

Deleted At
deletedAt string

When deleted at.

Published At
publishedAt string

The published at.

Create or update draft email

Creates or updates the draft version of a marketing email. If no draft exists, the system creates a draft from the current “live” email then applies the request body to that draft. The draft version only lives on the buffer—the email is not cloned.

Parameters

Name Key Required Type Description
Email ID
emailId True string

The email identifier.

Template Path
templatePath string

The template path.

Plain Text Version
plainTextVersion string

The plain text version.

From
fromName string

The from name.

Reply To
replyTo string

The reply to.

Custom Reply To
customReplyTo string

The custom reply to.

ID
id string

The identifier.

Name
name string

The name.

Send On Publish
sendOnPublish boolean

Whether to send on publish.

State
state string

The state.

Subcategory
subcategory string

The subcategory.

Subject
subject string

The subject.

Include
include array of string

The include array.

Exclude
exclude array of string

The exclude array.

Include
include array of string

The include array.

Exclude
exclude array of string

The exclude array.

Limit Send Frequency
limitSendFrequency boolean

Whether to limit send frequency.

Suppress Graymail
suppressGraymail boolean

Whether to suppress graymail.

Created By ID
createdById string

The created by identifier.

Type
type string

The type.

Active Domain
activeDomain string

The active domain.

Archived
archived boolean

Whether archived.

Folder ID
folderId string

The folder identifier.

Feedback Survey ID
feedbackSurveyId string

The feedback survey identifier.

Test ID
testId string

The test identifier.

Hours To Wait
hoursToWait integer

The hours to wait.

AB Success Metric
abSuccessMetric string

The A/B success metric.

AB Sample Size Default
abSampleSizeDefault string

The A/B sample size default.

AB Status
abStatus string

The A/B status.

AB Test Percentage
abTestPercentage string

The A/B test percentage.

AB Sampling Default
abSamplingDefault string

The A/B sampling default.

Subscription ID
subscriptionId string

The subscription identifier.

Preferences Group ID
preferencesGroupId string

The preferences group identifier.

Office Location ID
officeLocationId string

The office location identifier.

Updated By ID
updatedById string

The updated by identifier.

Published By ID
publishedById string

The published by identifier.

Language
language string

The langauge.

Campaign
campaign string

The campaign.

Slug
slug string

The slug.

Domain
domain string

The domain.

Title
title string

The title.

Meta Description
metaDescription string

The meta description.

Redirect To URL
redirectToUrl string

The redirect to URL address.

Redirect To Page ID
redirectToPageId string

The redirect to page identifier.

Expires At
expiresAt string

When expires at.

Max Entries
maxEntries string

The max entries.

URL
url string

The URL address.

HubSpot Blog ID
hubspotBlogId string

The HubSpot blog identifier.

Blog Email Type
blogEmailType string

The blog email type.

Blog Image Max Width
blogImageMaxWidth string

The blog image max width.

Entry Template
rssEntryTemplate string

The entry template.

Use Headline As Subject
useHeadlineAsSubject boolean

Whether to use headline as subject.

Blog Layout
blogLayout string

The blog layout.

Is Transactional
isTransactional boolean

Whether is transactional.

Is Published
isPublished boolean

Whether is published.

Published Date
publishDate string

The published date.

Updated At
updatedAt string

When updated at.

Created At
createdAt string

When created at.

Deleted At
deletedAt string

When deleted at.

Published At
publishedAt string

The published at.

Returns

Name Path Type Description
Template Path
content.templatePath string

The template path.

Plain Text Version
content.plainTextVersion string

The plain text version.

From
from.fromName string

The from name.

Reply To
from.replyTo string

The reply to.

Custom Reply To
from.customReplyTo string

The custom reply to.

ID
id string

The identifier.

Name
name string

The name.

Send On Publish
sendOnPublish boolean

Whether to send on publish.

State
state string

The state.

Subcategory
subcategory string

The subcategory.

Subject
subject string

The subject.

Include
to.contactLists.include array of string

The include array.

Exclude
to.contactLists.exclude array of string

The exclude array.

Include
to.contactIds.include array of string

The include array.

Exclude
to.contactIds.exclude array of string

The exclude array.

Limit Send Frequency
to.limitSendFrequency boolean

Whether to limit send frequency.

Suppress Graymail
to.suppressGraymail boolean

Whether to suppress graymail.

Created By ID
createdById string

The created by identifier.

Type
type string

The type.

Active Domain
activeDomain string

The active domain.

Archived
archived boolean

Whether archived.

Folder ID
folderId string

The folder identifier.

Feedback Survey ID
feedbackSurveyId string

The feedback survey identifier.

Test ID
testing.testId string

The test identifier.

Hours To Wait
testing.hoursToWait integer

The hours to wait.

AB Success Metric
testing.abSuccessMetric string

The A/B success metric.

AB Sample Size Default
testing.abSampleSizeDefault string

The A/B sample size default.

AB Status
testing.abStatus string

The A/B status.

AB Test Percentage
testing.abTestPercentage string

The A/B test percentage.

AB Sampling Default
testing.abSamplingDefault string

The A/B sampling default.

Subscription ID
subscriptionDetails.subscriptionId string

The subscription identifier.

Preferences Group ID
subscriptionDetails.preferencesGroupId string

The preferences group identifier.

Office Location ID
subscriptionDetails.officeLocationId string

The office location identifier.

Updated By ID
updatedById string

The updated by identifier.

Published By ID
publishedById string

The published by identifier.

Language
language string

The langauge.

Campaign
campaign string

The campaign.

Slug
webversion.slug string

The slug.

Domain
webversion.domain string

The domain.

Title
webversion.title string

The title.

Meta Description
webversion.metaDescription string

The meta description.

Redirect To URL
webversion.redirectToUrl string

The redirect to URL address.

Redirect To Page ID
webversion.redirectToPageId string

The redirect to page identifier.

Expires At
webversion.expiresAt string

When expires at.

Max Entries
rssData.maxEntries string

The max entries.

URL
rssData.url string

The URL address.

HubSpot Blog ID
rssData.hubspotBlogId string

The HubSpot blog identifier.

Blog Email Type
rssData.blogEmailType string

The blog email type.

Blog Image Max Width
rssData.blogImageMaxWidth string

The blog image max width.

Entry Template
rssData.rssEntryTemplate string

The entry template.

Use Headline As Subject
rssData.useHeadlineAsSubject boolean

Whether to use headline as subject.

Blog Layout
rssData.blogLayout string

The blog layout.

Is Transactional
isTransactional boolean

Whether is transactional.

Is Published
isPublished boolean

Whether is published.

Published Date
publishDate string

The published date.

Updated At
updatedAt string

When updated at.

Created At
createdAt string

When created at.

Deleted At
deletedAt string

When deleted at.

Published At
publishedAt string

The published at.

Create SMTP token

Creates a SMTP token.

Parameters

Name Key Required Type Description
Campaign Name
campaignName string

The campaign name.

Create Contact
createContact string

The create contact.

Returns

Name Path Type Description
Campaign Name
campaignName string

The campaign name.

Create Contact
createContact string

The create contact.

Created At
createdAt string

When created at.

Created By
createdBy string

The created by.

Email Campaign ID
emailCampaignId string

The email campaign identifier.

ID
id string

The identifier.

Password
password string

The password.

Delete marketing email

Deletes a marketing email.

Parameters

Name Key Required Type Description
Archived
archived boolean

Whether archived.

Email ID
emailId True string

The email identifier.

Returns

response
string

Delete token

Deletes a single token by identifier.

Parameters

Name Key Required Type Description
Token
tokenId True string

The token identifier.

Returns

response
string

Get a revision of a marketing email

Retrieves a specific revision of a marketing email.

Parameters

Name Key Required Type Description
Email ID
emailId True string

The email identifier.

Revision ID
revisionId True string

The revision identifier.

Returns

Name Path Type Description
ID
id string

The identifier.

Template Path
object.content.templatePath string

The template path.

Plain Text Version
object.content.plainTextVersion string

The plain text version.

Name
object.from.fromName string

The from name.

Reply To
object.from.replyTo string

The reply to.

Custom Reply To
object.from.customReplyTo string

The custom reply to.

ID
object.id string

The identifier.

Name
object.name string

The name.

Send On Publish
object.sendOnPublish boolean

Whether to send on publish.

State
object.state string

The state.

Subcategory
object.subcategory string

The subcategory.

Subject
object.subject string

The subject.

Include
object.to.contactLists.include array of string

The include array.

Exclude
object.to.contactLists.exclude array of string

The exclude array.

Include
object.to.contactIds.include array of string

The include array.

Exclude
object.to.contactIds.exclude array of string

The exclude array.

Limit Send Frequency
object.to.limitSendFrequency boolean

Whether to limit send frequency.

Suppress Graymail
object.to.suppressGraymail boolean

Whether to suppress graymail.

Created By ID
object.createdById string

The created by identifier.

Type
object.type string

The type.

Active Domain
object.activeDomain string

The active domain.

Archived
object.archived boolean

Whether archived.

Folder ID
object.folderId string

The folder identifier.

Feedback Survey ID
object.feedbackSurveyId string

The feedback survey identifier.

Test ID
object.testing.testId string

The test identifier.

Hours To Wait
object.testing.hoursToWait integer

The hours to wait.

AB Success Metric
object.testing.abSuccessMetric string

The A/B success metric.

AB Sample Size Default
object.testing.abSampleSizeDefault string

The A/B sample size default.

AB Status
object.testing.abStatus string

The A/B status.

AB Test Percentage
object.testing.abTestPercentage string

The A/B test percentage.

AB Sampling Default
object.testing.abSamplingDefault string

The A/B sampling default.

ID
object.subscriptionDetails.subscriptionId string

The subscription identifier.

Preferences Group ID
object.subscriptionDetails.preferencesGroupId string

The preferences group identifier.

Office Location ID
object.subscriptionDetails.officeLocationId string

The office location identifier.

Updated By ID
object.updatedById string

The updated by identifier.

Published By ID
object.publishedById string

The published by identifier.

Language
object.language string

The language.

Campaign
object.campaign string

The campaign.

Slug
object.webversion.slug string

The slug.

Domain
object.webversion.domain string

The domain.

Title
object.webversion.title string

The title.

Meta Description
object.webversion.metaDescription string

The meta description.

Redirect To URL
object.webversion.redirectToUrl string

The redirect to URL address.

Redirect To Page ID
object.webversion.redirectToPageId string

The redirect to page identifier.

Expires At
object.webversion.expiresAt string

When expires at.

Max Entries
object.rssData.maxEntries string

The max entries.

URL
object.rssData.url string

The URL address.

HubSpot Blog ID
object.rssData.hubspotBlogId string

The HubSpot blog identifier.

Blog Email Type
object.rssData.blogEmailType string

The blog email type.

Blog Image Max Width
object.rssData.blogImageMaxWidth string

The blog image max width.

Entry Template
object.rssData.rssEntryTemplate string

The entry template.

Use Headline As Subject
object.rssData.useHeadlineAsSubject boolean

Whether to use headline as subject.

Blog Layout
object.rssData.blogLayout string

The blog layout.

Is Transactional
object.isTransactional boolean

Whether is transactional.

Is Published
object.isPublished boolean

Whether is published.

Published Date
object.publishDate string

The published date.

Updated At
object.updatedAt string

When updated at.

Created At
object.createdAt string

When created at.

Deleted At
object.deletedAt string

When deleted at.

Published At
object.publishedAt string

When published at.

Updated At
updatedAt string

When updated at.

Email
user.email string

The email address.

Full Name
user.fullName string

The full name.

ID
user.id string

The identifier.

Get AB marketing email variation

Retrieves the variation of an A/B marketing email. If the email is variation A (master) it will return variation B (variant) and vice versa.

Parameters

Name Key Required Type Description
Email ID
emailId True string

The email identifier.

Returns

Name Path Type Description
Template Path
content.templatePath string

The template path.

Plain Text Version
content.plainTextVersion string

The plain text version.

Name
from.fromName string

The from name.

Reply To
from.replyTo string

The reply to.

Custom Reply To
from.customReplyTo string

The custom reply to.

ID
id string

The identifier.

Name
name string

The name.

Send On Publish
sendOnPublish boolean

Whether to send on publish.

State
state string

The state.

Subcategory
subcategory string

The subcategory.

Subject
subject string

The subject.

Include
to.contactLists.include array of string

The include array.

Exclude
to.contactLists.exclude array of string

The exclude array.

Include
to.contactIds.include array of string

The include array.

Exclude
to.contactIds.exclude array of string

The exclude array.

Limit Send Frequency
to.limitSendFrequency boolean

Whether to limit send frequency.

Suppress Graymail
to.suppressGraymail boolean

Whether to suppress graymail.

Created By ID
createdById string

The created by identifier.

Type
type string

The type.

Active Domain
activeDomain string

The active domain.

Archived
archived boolean

Whether archived.

Folder ID
folderId string

The folder identifier.

Feedback Survey ID
feedbackSurveyId string

The feedback survey identifier.

Test ID
testing.testId string

The test identifier.

Hours To Wait
testing.hoursToWait integer

The hours to wait.

AB Success Metric
testing.abSuccessMetric string

The A/B success metric.

AB Sample Size Default
testing.abSampleSizeDefault string

The A/B sample size default.

AB Status
testing.abStatus string

The A/B status.

AB Test Percentage
testing.abTestPercentage string

The A/B test percentage.

AB Sampling Default
testing.abSamplingDefault string

The A/B sampling default.

Subscription ID
subscriptionDetails.subscriptionId string

The subscription identifier.

Preferences Group ID
subscriptionDetails.preferencesGroupId string

The preferences group identifier.

Office Location ID
subscriptionDetails.officeLocationId string

The office location identifier.

Updated By ID
updatedById string

The updated by identifier.

Published By ID
publishedById string

The published by identifier.

Language
language string

The langauge.

Campaign
campaign string

The campaign.

Slug
webversion.slug string

The slug.

Domain
webversion.domain string

The domain.

Title
webversion.title string

The title.

Meta Description
webversion.metaDescription string

The meta description.

Redirect To URL
webversion.redirectToUrl string

The redirect to URL address.

Redirect To Page ID
webversion.redirectToPageId string

The redirect to page identifier.

Expires At
webversion.expiresAt string

When expires at.

Max Entries
rssData.maxEntries string

The max entries.

URL
rssData.url string

The URL address.

HubSpot Blog ID
rssData.hubspotBlogId string

The HubSpot blog identifier.

Blog Email Type
rssData.blogEmailType string

The blog email type.

Blog Image Max Width
rssData.blogImageMaxWidth string

The blog image max width.

Entry Template
rssData.rssEntryTemplate string

The entry template.

Use Headline As Subject
rssData.useHeadlineAsSubject boolean

Whether to use headline as subject.

Blog Layout
rssData.blogLayout string

The blog layout.

Is Transactional
isTransactional boolean

Whether is transactional.

Is Published
isPublished boolean

Whether is published.

Published Date
publishDate string

The published date.

Updated At
updatedAt string

When updated at.

Created At
createdAt string

When created at.

Deleted At
deletedAt string

When deleted at.

Published At
publishedAt string

The published at.

Get aggregated statistic intervals

Retrieves aggregated statistics in intervals for a specified time span. Each interval contains aggregated statistics of the emails that were sent in that time.

Parameters

Name Key Required Type Description
Interval
interval string

The interval.

Start
startTimestamp string

The start timestamp.

End
endTimestamp string

The end timestamp.

Email IDs
emailIds string

The email identifiers.

Returns

Name Path Type Description
Results
results array of object
End
results.interval.end string

The end.

Start
results.interval.start string

The start.

Total
total integer

The total.

Get aggregated statistics

Retrieves aggregated statistics of emails sent in a specified time span. It also returns the list of emails that were sent during the time span.

Parameters

Name Key Required Type Description
Start
startTimestamp string

The start timestamp.

End
endTimestamp string

The end timestamp.

Email IDs
emailIds string

The email identifiers.

Property
property string

The property.

Returns

Name Path Type Description
Emails
emails array of string

The email addresses array.

Get contact subscription statuses

Returns a list of subscriptions and their status for a given contact.

Parameters

Name Key Required Type Description
Email Address
emailAddress True string

The email address.

Returns

Name Path Type Description
Recipient
recipient string

The recipient.

Subscription Statuses
subscriptionStatuses array of object
Description
subscriptionStatuses.description string

The description.

ID
subscriptionStatuses.id string

The identifier.

Name
subscriptionStatuses.name string

The name.

Source Of Status
subscriptionStatuses.sourceOfStatus string

The source of status.

Status
subscriptionStatuses.status string

The status.

Brand ID
subscriptionStatuses.brandId string

The brand identifier.

Preference Group
subscriptionStatuses.preferenceGroupName string

The preference group name.

Legal Basis
subscriptionStatuses.legalBasis string

The legal basis.

Legal Basis Explanation
subscriptionStatuses.legalBasisExplanation string

The legal basis explanation.

Get marketing email

Retrieves the details for a marketing email.

Parameters

Name Key Required Type Description
Include Stats
includeStats boolean

Whether to include stats.

Include Properties
includedProperties boolean

Whether to include properties.

Archived
archived boolean

Whether archived.

Email ID
emailId True string

The email identifier.

Returns

Name Path Type Description
Template Path
content.templatePath string

The template path.

Plain Text Version
content.plainTextVersion string

The plain text version.

From
from.fromName string

The from name.

Reply To
from.replyTo string

The reply to.

Custom Reply To
from.customReplyTo string

The custom reply to.

ID
id string

The identifier.

Name
name string

The name.

Send On Publish
sendOnPublish boolean

Whether to send on publish.

State
state string

The state.

Subcategory
subcategory string

The subcategory.

Subject
subject string

The subject.

Include
to.contactLists.include array of string

The include array.

Exclude
to.contactLists.exclude array of string

The exclude array.

Include
to.contactIds.include array of string

The include array.

Exclude
to.contactIds.exclude array of string

The exclude array.

Limit Send Frequency
to.limitSendFrequency boolean

Whether to limit send frequency.

Suppress Graymail
to.suppressGraymail boolean

Whether to suppress graymail.

Created By ID
createdById string

The created by identifier.

Type
type string

The type.

Active Domain
activeDomain string

The active domain.

Archived
archived boolean

Whether archived.

Folder ID
folderId string

The folder identifier.

Feedback Survey ID
feedbackSurveyId string

The feedback survey identifier.

Test ID
testing.testId string

The test identifier.

Hours To Wait
testing.hoursToWait integer

The hours to wait.

AB Success Metric
testing.abSuccessMetric string

The A/B success metric.

AB Sample Size Default
testing.abSampleSizeDefault string

The A/B sample size default.

AB Status
testing.abStatus string

The A/B status.

AB Test Percentage
testing.abTestPercentage string

The A/B test percentage.

AB Sampling Default
testing.abSamplingDefault string

The A/B sampling default.

Subscription ID
subscriptionDetails.subscriptionId string

The subscription identifier.

Preferences Group ID
subscriptionDetails.preferencesGroupId string

The preferences group identifier.

Office Location ID
subscriptionDetails.officeLocationId string

The office location identifier.

Updated By ID
updatedById string

The updated by identifier.

Published By ID
publishedById string

The published by identifier.

Language
language string

The langauge.

Campaign
campaign string

The campaign.

Slug
webversion.slug string

The slug.

Domain
webversion.domain string

The domain.

Title
webversion.title string

The title.

Meta Description
webversion.metaDescription string

The meta description.

Redirect To URL
webversion.redirectToUrl string

The redirect to URL address.

Redirect To Page ID
webversion.redirectToPageId string

The redirect to page identifier.

Expires At
webversion.expiresAt string

When expires at.

Max Entries
rssData.maxEntries string

The max entries.

URL
rssData.url string

The URL address.

HubSpot Blog ID
rssData.hubspotBlogId string

The HubSpot blog identifier.

Blog Email Type
rssData.blogEmailType string

The blog email type.

Blog Image Max Width
rssData.blogImageMaxWidth string

The blog image max width.

Entry Template
rssData.rssEntryTemplate string

The entry template.

Use Headline As Subject
rssData.useHeadlineAsSubject boolean

Whether to use headline as subject.

Blog Layout
rssData.blogLayout string

The blog layout.

Is Transactional
isTransactional boolean

Whether is transactional.

Is Published
isPublished boolean

Whether is published.

Published Date
publishDate string

The published date.

Updated At
updatedAt string

When updated at.

Created At
createdAt string

When created at.

Deleted At
deletedAt string

When deleted at.

Published At
publishedAt string

The published at.

Get marketing email draft

Retrieves the draft version of an email (if it exists). If no draft version exists, the published email is returned.

Parameters

Name Key Required Type Description
Email ID
emailId True string

The email identifier.

Returns

Name Path Type Description
Template Path
content.templatePath string

The template path.

Plain Text Version
content.plainTextVersion string

The plain text version.

From
from.fromName string

The from name.

Reply To
from.replyTo string

The reply to.

Custom Reply To
from.customReplyTo string

The custom reply to.

ID
id string

The identifier.

Name
name string

The name.

Send On Publish
sendOnPublish boolean

Whether to send on publish.

State
state string

The state.

Subcategory
subcategory string

The subcategory.

Subject
subject string

The subject.

Include
to.contactLists.include array of string

The include array.

Exclude
to.contactLists.exclude array of string

The exclude array.

Include
to.contactIds.include array of string

The include array.

Exclude
to.contactIds.exclude array of string

The exclude array.

Limit Send Frequency
to.limitSendFrequency boolean

Whether to limit send frequency.

Suppress Graymail
to.suppressGraymail boolean

Whether to suppress graymail.

Created By ID
createdById string

The created by identifier.

Type
type string

The type.

Active Domain
activeDomain string

The active domain.

Archived
archived boolean

Whether archived.

Folder ID
folderId string

The folder identifier.

Feedback Survey ID
feedbackSurveyId string

The feedback survey identifier.

Test ID
testing.testId string

The test identifier.

Hours To Wait
testing.hoursToWait integer

The hours to wait.

AB Success Metric
testing.abSuccessMetric string

The A/B success metric.

AB Sample Size Default
testing.abSampleSizeDefault string

The A/B sample size default.

AB Status
testing.abStatus string

The A/B status.

AB Test Percentage
testing.abTestPercentage string

The A/B test percentage.

AB Sampling Default
testing.abSamplingDefault string

The A/B sampling default.

Subscription ID
subscriptionDetails.subscriptionId string

The subscription identifier.

Preferences Group ID
subscriptionDetails.preferencesGroupId string

The preferences group identifier.

Office Location ID
subscriptionDetails.officeLocationId string

The office location identifier.

Updated By ID
updatedById string

The updated by identifier.

Published By ID
publishedById string

The published by identifier.

Language
language string

The langauge.

Campaign
campaign string

The campaign.

Slug
webversion.slug string

The slug.

Domain
webversion.domain string

The domain.

Title
webversion.title string

The title.

Meta Description
webversion.metaDescription string

The meta description.

Redirect To URL
webversion.redirectToUrl string

The redirect to URL address.

Redirect To Page ID
webversion.redirectToPageId string

The redirect to page identifier.

Expires At
webversion.expiresAt string

When expires at.

Max Entries
rssData.maxEntries string

The max entries.

URL
rssData.url string

The URL address.

HubSpot Blog ID
rssData.hubspotBlogId string

The HubSpot blog identifier.

Blog Email Type
rssData.blogEmailType string

The blog email type.

Blog Image Max Width
rssData.blogImageMaxWidth string

The blog image max width.

Entry Template
rssData.rssEntryTemplate string

The entry template.

Use Headline As Subject
rssData.useHeadlineAsSubject boolean

Whether to use headline as subject.

Blog Layout
rssData.blogLayout string

The blog layout.

Is Transactional
isTransactional boolean

Whether is transactional.

Is Published
isPublished boolean

Whether is published.

Published Date
publishDate string

The published date.

Updated At
updatedAt string

When updated at.

Created At
createdAt string

When created at.

Deleted At
deletedAt string

When deleted at.

Published At
publishedAt string

The published at.

Get marketing email revisions

Retrieves a list of all versions of a marketing email, with each entry including the full state of that particular version. The current revision has the ID -1.

Parameters

Name Key Required Type Description
After
after string

The after.

Before
before string

The before.

Limit
limit string

The limit.

Email ID
emailId True string

The email identifier.

Returns

Name Path Type Description
Results
results array of object
ID
results.id string

The identifier.

AB Hours To Wait
results.object.abHoursToWait string

The A/B hours to wait.

AB Status
results.object.abStatus string

The A/B status.

AB Test ID
results.object.abTestId string

The A/B test identifier.

Archived At
results.object.archivedAt string

When archived at.

Archived In Dashboard
results.object.archivedInDashboard boolean

Whether archived in dashboard.

Attached Stylesheets
results.object.attachedStylesheets array of object

The attached stylesheets object.

Author
results.object.authorName string

The author name.

Blog Email Type
results.object.blogEmailType string

The blog email type.

Campaign
results.object.campaign string

The campaign.

Category ID
results.object.categoryId string

The category identifier.

Content Group ID
results.object.contentGroupId string

The content group identifier.

Content Type Category
results.object.contentTypeCategory string

The content type category.

Create Page
results.object.createPage string

The create page.

Created
results.object.created string

When created.

Created By ID
results.object.createdById string

The created by identifier.

Current State
results.object.currentState string

The current state.

Currently Published
results.object.currentlyPublished boolean

Whether currently published.

Custom Reply To
results.object.customReplyTo string

The custom reply to.

Custom Reply To Enabled
results.object.customReplyToEnabled boolean

Whether custom reply to enabled.

Domain
results.object.domain string

The domain.

Dynamic Page Data Source ID
results.object.dynamicPageDataSourceId string

The dynamic page data source identifier.

Dynamic Page Data Source Type
results.object.dynamicPageDataSourceType string

The dynamic page data source type.

Dynamic Page HubDb Table ID
results.object.dynamicPageHubDbTableId string

The dynamic page HubDb table identifier.

Email Type
results.object.emailType string

The email type.

Enable Domain Stylesheets
results.object.enableDomainStylesheets boolean

Whether to enable domain stylesheets.

Enable Layout Stylesheets
results.object.enableLayoutStylesheets boolean

Whether to enable layout stylesheets.

Featured Image
results.object.featuredImage string

The featured image.

Featured Image Alt Text
results.object.featuredImageAltText string

The featured image alt text.

Folder ID
results.object.folderId string

The folder identifier.

Footer HTML
results.object.footerHtml string

The footer HTML code.

From
results.object.fromName string

The from name.

Head HTML
results.object.headHtml string

The head HTML code.

Html Title
results.object.htmlTitle string

The HTML title.

ID
results.object.id string

The identifier.

Include Default Custom CSS
results.object.includeDefaultCustomCss boolean

Whether to include default custom CSS.

Is Graymail Suppression Enabled
results.object.isGraymailSuppressionEnabled boolean

Whether is graymail suppression enabled.

Language
results.object.language string

The language.

Link Rel Canonical URL
results.object.linkRelCanonicalUrl string

The link rel canonical URL address.

Mab Experiment ID
results.object.mabExperimentId string

The mab experiment identifier.

Mailing Lists Excluded
results.object.mailingListsExcluded array of string

The mailing lists excluded array.

Mailing Lists Included
results.object.mailingListsIncluded array of string

The mailing lists included array.

Max RSS Entries
results.object.maxRssEntries integer

The max RSS entries.

Meta Description
results.object.metaDescription string

The meta description.

Name
results.object.name string

The name.

Page Expiry Date
results.object.pageExpiryDate string

The page expiry date.

Page Expiry Enabled
results.object.pageExpiryEnabled boolean

Whether page expiry enabled.

Page Expiry Redirect ID
results.object.pageExpiryRedirectId string

The page expiry redirect identifier.

Page Expiry Redirect URL
results.object.pageExpiryRedirectUrl string

The page expiry redirect URL address.

Page Redirected
results.object.pageRedirected string

The page redirected.

Password
results.object.password string

The password.

Public Access Rules Enabled
results.object.publicAccessRulesEnabled boolean

Whether public access rules enabled.

Published Date
results.object.publishDate string

The published date.

Publish Immediately
results.object.publishImmediately boolean

Whether to publish immediately.

Reply To
results.object.replyTo string

The reply to.

RSS Email Author Line Template
results.object.rssEmailAuthorLineTemplate string

The RSS email author line template.

RSS Email Blog Image Max Width
results.object.rssEmailBlogImageMaxWidth string

The RSS email blog image max width.

RSS Email By Text
results.object.rssEmailByText string

The RSS email by text.

RSS Email Click Through Text
results.object.rssEmailClickThroughText string

The RSS email click through text.

RSS Email Comment Text
results.object.rssEmailCommentText string

The RSS email comment text.

RSS Email Entry Template
results.object.rssEmailEntryTemplate string

The RSS email entry template.

RSS Email Entry Template Enabled
results.object.rssEmailEntryTemplateEnabled string

The RSS email entry template enabled.

RSS Email ID
results.object.rssEmailId string

The RSS email identifier.

RSS Email URL
results.object.rssEmailUrl string

The RSS email URL address.

Slug
results.object.slug string

The slug.

State
results.object.state string

The state.

Subcategory
results.object.subcategory string

The subcategory.

Subject
results.object.subject string

The subject.

Subscription
results.object.subscription string

The subscription.

Subscription Blog ID
results.object.subscriptionBlogId string

The subscription blog identifier.

Subscription
results.object.subscriptionName string

The subscription name.

Template Path
results.object.templatePath string

The template path.

Transactional
results.object.transactional string

The transactional.

Translated From ID
results.object.translatedFromId string

The translated from identifier.

Updated
results.object.updated string

When updated.

Updated By ID
results.object.updatedById string

The updated by identifier.

URL
results.object.url string

The URL address.

Use Featured Image
results.object.useFeaturedImage boolean

Whether to use featured image.

Use RSS Headline As Subject
results.object.useRssHeadlineAsSubject boolean

Whether to use RSS headline as subject.

VIDs Excluded
results.object.vidsExcluded array of string

The VIDs excluded array.

VIDs Included
results.object.vidsIncluded array of string

The VIDs included array.

Workflows
results.object.workflowNames array of string

The workflow names.

Is Recipient Fatigue Suppression Enabled
results.object.isRecipientFatigueSuppressionEnabled boolean

Whether is recipient fatigue suppression enabled.

Feedback Survey ID
results.object.feedbackSurveyId string

The feedback survey identifier.

Email
results.user.email string

The email address.

Full Name
results.user.fullName string

The full name.

ID
results.user.id string

The identifier.

Updated At
results.updatedAt string

When updated at.

Total
total integer

The total.

After
paging.next.after string

The after link.

Link
paging.next.link string

The link.

Before
paging.prev.before string

The before link.

Link
paging.prev.link string

The link.

Get marketing emails

Retrieve a list of all marketing emails. The results can be filtered, allowing you to find a specific set of emails.

Parameters

Name Key Required Type Description
Created At
createdAt string

When created at.

Created After
createdAfter string

The created after.

Created Before
createdBefore string

The created before.

Updated At
updatedAt string

When updated at.

Updated After
updatedAfter string

The updated after.

Updated Before
updatedBefore string

The updated before.

Sort
sort string

The sort.

After
after string

The after.

Limit
limit string

The limit.

Include Stats
includeStats boolean

Whether to include stats.

Type
type string

The type.

Is Published
isPublished boolean

Whether is published.

Include Properties
includedProperties boolean

Whether to include properties.

Archived
archived boolean

Whether archived.

Returns

Name Path Type Description
Results
results array of object
Template Path
results.content.templatePath string

The template path.

Plain Text Version
results.content.plainTextVersion string

The plain text version.

From
results.from.fromName string

The from name.

Reply To
results.from.replyTo string

The reply to.

Custom Reply To
results.from.customReplyTo string

The custom reply to.

ID
results.id string

The identifier.

Name
results.name string

The name.

Send On Publish
results.sendOnPublish boolean

Whether to send on publish.

State
results.state string

The state.

Subcategory
results.subcategory string

The subcategory.

Subject
results.subject string

The subject.

Include
results.to.contactLists.include array of string

The included.

Exclude
results.to.contactLists.exclude array of string

The excluded.

Include
results.to.contactIds.include array of string

The included.

Exclude
results.to.contactIds.exclude array of string

The excluded.

Limit Send Frequency
results.to.limitSendFrequency boolean

Whether to limit send frequency.

Suppress Graymail
results.to.suppressGraymail boolean

Whether to suppress graymail.

Created By ID
results.createdById string

The created by identifier.

Type
results.type string

The type.

Active Domain
results.activeDomain string

The active domain.

Archived
results.archived boolean

Whether archived.

Folder ID
results.folderId string

The folder identifier.

Feedback Survey ID
results.feedbackSurveyId string

The feedback survey identifier.

Test ID
results.testing.testId string

The test identifier.

Hours To Wait
results.testing.hoursToWait integer

The hours to wait.

AB Success Metric
results.testing.abSuccessMetric string

The A/B success metric.

AB Sample Size Default
results.testing.abSampleSizeDefault string

The A/B sample size default.

AB Status
results.testing.abStatus string

The A/B status.

AB Test Percentage
results.testing.abTestPercentage string

The A/B test percentage.

AB Sampling Default
results.testing.abSamplingDefault string

The A/B sampling default.

Subscription ID
results.subscriptionDetails.subscriptionId string

The subscription identifier.

Preferences Group ID
results.subscriptionDetails.preferencesGroupId string

The preferences group identifier.

Office Location ID
results.subscriptionDetails.officeLocationId string

The office location identifier.

Updated By ID
results.updatedById string

The updated by identifier.

Published By ID
results.publishedById string

The published by identifier.

Language
results.language string

The language.

Campaign
results.campaign string

The campaign.

Slug
results.webversion.slug string

The slug.

Domain
results.webversion.domain string

The domain.

Title
results.webversion.title string

The title.

Meta Description
results.webversion.metaDescription string

The meta description.

Redirect To URL
results.webversion.redirectToUrl string

The redirect to URL address.

Redirect To Page ID
results.webversion.redirectToPageId string

The redirect to page identifier.

Expires At
results.webversion.expiresAt string

When expires at.

Max Entries
results.rssData.maxEntries string

The maximum entries

URL
results.rssData.url string

The URL address.

HubSpot Blog ID
results.rssData.hubspotBlogId string

The HubSpot blog identifier.

Blog Email Type
results.rssData.blogEmailType string

The blog email type.

Blog Image Max Width
results.rssData.blogImageMaxWidth string

The blog image max width.

RSS Entry Template
results.rssData.rssEntryTemplate string

The RSS .

Use Headline As Subject
results.rssData.useHeadlineAsSubject boolean

Whether to use headline as subject.

Blog Layout
results.rssData.blogLayout string

The blog layout.

Is Transactional
results.isTransactional boolean

Whether is transactional.

Is Published
results.isPublished boolean

Whether is published.

Publish Date
results.publishDate string

The publish date.

Updated At
results.updatedAt string

When updated at.

Created At
results.createdAt string

When created at.

Deleted At
results.deletedAt string

When deleted at.

Published At
results.publishedAt string

The published at.

Total
total integer

The total.

After
paging.next.after string

The after link.

Link
paging.next.link string

The link.

Get subscription definitions

Retrieves a list of all subscription definitions for the portal.

Returns

Name Path Type Description
Subscription Definitions
subscriptionDefinitions array of object
Created At
subscriptionDefinitions.createdAt string

When created at.

Description
subscriptionDefinitions.description string

The description.

ID
subscriptionDefinitions.id string

The identifier.

Is Active
subscriptionDefinitions.isActive boolean

Whether is active.

Is Default
subscriptionDefinitions.isDefault boolean

Whether is default.

Is Internal
subscriptionDefinitions.isInternal boolean

Whether is internal.

Name
subscriptionDefinitions.name string

The name.

Updated At
subscriptionDefinitions.updatedAt string

When updated at.

Purpose
subscriptionDefinitions.purpose string

The purpose.

Communication Method
subscriptionDefinitions.communicationMethod string

The communication method.

Query SMTP tokens

Queries multiple SMTP tokens by campaign name or a single token by email campaign identifier.

Parameters

Name Key Required Type Description
Campaign
campaignName string

The campaign name.

Email Campaign
emailCampaignId string

The email campaign identifier.

After
after string

The after.

Limit
limit string

The limit.

Returns

Name Path Type Description
Results
results array of object
Campaign Name
results.campaignName string

The campaign name.

Create Contact
results.createContact string

The create contact.

Created At
results.createdAt string

When created at.

Created By
results.createdBy string

The created by.

Email Campaign ID
results.emailCampaignId string

The email campaign identifier.

ID
results.id string

The identifier.

Password
results.password string

The password.

After
paging.next.after string

The after link.

Link
paging.next.link string

The link.

Query token

Queries a single token by identifier.

Parameters

Name Key Required Type Description
Token
tokenId True string

The token identifier.

Returns

Name Path Type Description
Campaign Name
campaignName string

The campaign name.

Create Contact
createContact string

The create contact.

Created At
createdAt string

When created at.

Created By
createdBy string

The created by.

Email Campaign ID
emailCampaignId string

The email campaign identifier.

ID
id string

The identifier.

Password
password string

The password.

Reset Draft

Resets the draft back to a copy of the live object.

Parameters

Name Key Required Type Description
Email ID
emailId True string

The email identifier.

Returns

response
string

Reset token password

Allows the creation of a replacement password for a given token. Once the password is successfully reset, the old password for the token will be invalid.

Parameters

Name Key Required Type Description
Token
tokenId True string

The token identifier.

Returns

Name Path Type Description
Campaign Name
campaignName string

The campaign name.

Create Contact
createContact string

The create contact.

Created At
createdAt string

When created at.

Created By
createdBy string

The created by.

Email Campaign ID
emailCampaignId string

The email campaign identifier.

ID
id string

The identifier.

Password
password string

The password.

Restore draft marketing email

Restores a previous revision of a marketing email to DRAFT state. If there is currently something in the draft for that object, it is overwritten.

Parameters

Name Key Required Type Description
Email ID
emailId True string

The email identifier.

Revision ID
revisionId True string

The revision identifier.

Returns

Name Path Type Description
Template Path
content.templatePath string

The template path.

Plain Text Version
content.plainTextVersion string

The plain text version.

From
from.fromName string

The from name.

Reply To
from.replyTo string

The reply to.

Custom Reply To
from.customReplyTo string

The custom reply to.

ID
id string

The identifier.

Name
name string

The name.

Send On Publish
sendOnPublish boolean

Whether to send on publish.

State
state string

The state.

Subcategory
subcategory string

The subcategory.

Subject
subject string

The subject.

Include
to.contactLists.include array of string

The include array.

Exclude
to.contactLists.exclude array of string

The exclude array.

Include
to.contactIds.include array of string

The include array.

Exclude
to.contactIds.exclude array of string

The exclude array.

Limit Send Frequency
to.limitSendFrequency boolean

Whether to limit send frequency.

Suppress Graymail
to.suppressGraymail boolean

Whether to suppress graymail.

Created By ID
createdById string

The created by identifier.

Type
type string

The type.

Active Domain
activeDomain string

The active domain.

Archived
archived boolean

Whether archived.

Folder ID
folderId string

The folder identifier.

Feedback Survey ID
feedbackSurveyId string

The feedback survey identifier.

Test ID
testing.testId string

The test identifier.

Hours To Wait
testing.hoursToWait integer

The hours to wait.

AB Success Metric
testing.abSuccessMetric string

The A/B success metric.

AB Sample Size Default
testing.abSampleSizeDefault string

The A/B sample size default.

AB Status
testing.abStatus string

The A/B status.

AB Test Percentage
testing.abTestPercentage string

The A/B test percentage.

AB Sampling Default
testing.abSamplingDefault string

The A/B sampling default.

Subscription ID
subscriptionDetails.subscriptionId string

The subscription identifier.

Preferences Group ID
subscriptionDetails.preferencesGroupId string

The preferences group identifier.

Office Location ID
subscriptionDetails.officeLocationId string

The office location identifier.

Updated By ID
updatedById string

The updated by identifier.

Published By ID
publishedById string

The published by identifier.

Language
language string

The langauge.

Campaign
campaign string

The campaign.

Slug
webversion.slug string

The slug.

Domain
webversion.domain string

The domain.

Title
webversion.title string

The title.

Meta Description
webversion.metaDescription string

The meta description.

Redirect To URL
webversion.redirectToUrl string

The redirect to URL address.

Redirect To Page ID
webversion.redirectToPageId string

The redirect to page identifier.

Expires At
webversion.expiresAt string

When expires at.

Max Entries
rssData.maxEntries string

The max entries.

URL
rssData.url string

The URL address.

HubSpot Blog ID
rssData.hubspotBlogId string

The HubSpot blog identifier.

Blog Email Type
rssData.blogEmailType string

The blog email type.

Blog Image Max Width
rssData.blogImageMaxWidth string

The blog image max width.

Entry Template
rssData.rssEntryTemplate string

The entry template.

Use Headline As Subject
rssData.useHeadlineAsSubject boolean

Whether to use headline as subject.

Blog Layout
rssData.blogLayout string

The blog layout.

Is Transactional
isTransactional boolean

Whether is transactional.

Is Published
isPublished boolean

Whether is published.

Published Date
publishDate string

The published date.

Updated At
updatedAt string

When updated at.

Created At
createdAt string

When created at.

Deleted At
deletedAt string

When deleted at.

Published At
publishedAt string

The published at.

Restore marketing email revision

Restores a previous revision of a marketing email. The current revision becomes old, and the restored revision is given a new version number.

Parameters

Name Key Required Type Description
Email ID
emailId True string

The email identifier.

Revision ID
revisionId True string

The revision identifier.

Returns

response
string

Send email

Asynchronously send a transactional email. Returns the status of the email send with a status identifier that can be used to continuously query for the status using the Email Send Status.

Parameters

Name Key Required Type Description
Email ID
emailId string

The email identifier.

To
to string

The to address.

From
from string

The from address.

Send ID
sendId string

The send identifier.

Reply To
replyTo array of string

The reply to array.

CC
cc array of string

The CC array.

BCC
bcc array of string

The BCC array.

Returns

Name Path Type Description
Status
status string

The status.

Status ID
statusId string

The status identifier.

Send Result
sendResult string

The send result.

Requested At
requestedAt string

When requested at.

Started At
startedAt string

When started at.

Completed At
completedAt string

When completed at.

Created
eventId.created string

When created.

ID
eventId.id string

The identifier.

Subscribe contact

Subscribes a contact to the given subscription type. This action is not valid to use for subscribing a contact at a brand or portal level and will return an error.

Parameters

Name Key Required Type Description
Email Address
emailAddress string

The email address.

Subscription ID
subscriptionId string

The subscription identifier.

Legal Basis
legalBasis string

The legal basis.

Legal Basis Explanation
legalBasisExplanation string

The legal basis explanation.

Returns

Name Path Type Description
Description
description string

The description.

ID
id string

The identifier.

Name
name string

The name.

Source Of Status
sourceOfStatus string

The source of status.

Status
status string

The status.

Brand ID
brandId string

The brand identifier.

Preference Group
preferenceGroupName string

The preference group name.

Legal Basis
legalBasis string

The legal basis.

Legal Basis Explanation
legalBasisExplanation string

The legal basis explanation.

Unsubscribe contact

Unsubscribes a contact from the given subscription type. This action is not valid to use for unsubscribing a contact at a brand or portal level and will return an error.

Parameters

Name Key Required Type Description
Email Address
emailAddress string

The email address.

Subscription ID
subscriptionId string

The subscription identifier.

Legal Basis
legalBasis string

The legal basis.

Legal Basis Explanation
legalBasisExplanation string

The legal basis explanation.

Returns

Name Path Type Description
Description
description string

The description.

ID
id string

The identifier.

Name
name string

The name.

Source Of Status
sourceOfStatus string

The source of status.

Status
status string

The status.

Brand ID
brandId string

The brand identifier.

Preference Group
preferenceGroupName string

The preference group name.

Legal Basis
legalBasis string

The legal basis.

Legal Basis Explanation
legalBasisExplanation string

The legal basis explanation.

Update marketing email

Change properties of a marketing email.

Parameters

Name Key Required Type Description
Archived
archived boolean

Whether archived.

Email ID
emailId True string

The email identifier.

Template Path
templatePath string

The template path.

Plain Text Version
plainTextVersion string

The plain text version.

From
fromName string

The from name.

Reply To
replyTo string

The reply to.

Custom Reply To
customReplyTo string

The custom reply to.

ID
id string

The identifier.

Name
name string

The name.

Send On Publish
sendOnPublish boolean

Whether to send on publish.

State
state string

The state.

Subcategory
subcategory string

The subcategory.

Subject
subject string

The subject.

Include
include array of string

The include array.

Exclude
exclude array of string

The exclude array.

Include
include array of string

The include array.

Exclude
exclude array of string

The exclude array.

Limit Send Frequency
limitSendFrequency boolean

Whether to limit send frequency.

Suppress Graymail
suppressGraymail boolean

Whether to suppress graymail.

Created By ID
createdById string

The created by identifier.

Type
type string

The type.

Active Domain
activeDomain string

The active domain.

Archived
archived boolean

Whether archived.

Folder ID
folderId string

The folder identifier.

Feedback Survey ID
feedbackSurveyId string

The feedback survey identifier.

Test ID
testId string

The test identifier.

Hours To Wait
hoursToWait integer

The hours to wait.

AB Success Metric
abSuccessMetric string

The A/B success metric.

AB Sample Size Default
abSampleSizeDefault string

The A/B sample size default.

AB Status
abStatus string

The A/B status.

AB Test Percentage
abTestPercentage string

The A/B test percentage.

AB Sampling Default
abSamplingDefault string

The A/B sampling default.

Subscription ID
subscriptionId string

The subscription identifier.

Preferences Group ID
preferencesGroupId string

The preferences group identifier.

Office Location ID
officeLocationId string

The office location identifier.

Updated By ID
updatedById string

The updated by identifier.

Published By ID
publishedById string

The published by identifier.

Language
language string

The langauge.

Campaign
campaign string

The campaign.

Slug
slug string

The slug.

Domain
domain string

The domain.

Title
title string

The title.

Meta Description
metaDescription string

The meta description.

Redirect To URL
redirectToUrl string

The redirect to URL address.

Redirect To Page ID
redirectToPageId string

The redirect to page identifier.

Expires At
expiresAt string

When expires at.

Max Entries
maxEntries string

The max entries.

URL
url string

The URL address.

HubSpot Blog ID
hubspotBlogId string

The HubSpot blog identifier.

Blog Email Type
blogEmailType string

The blog email type.

Blog Image Max Width
blogImageMaxWidth string

The blog image max width.

Entry Template
rssEntryTemplate string

The entry template.

Use Headline As Subject
useHeadlineAsSubject boolean

Whether to use headline as subject.

Blog Layout
blogLayout string

The blog layout.

Is Transactional
isTransactional boolean

Whether is transactional.

Is Published
isPublished boolean

Whether is published.

Published Date
publishDate string

The published date.

Updated At
updatedAt string

When updated at.

Created At
createdAt string

When created at.

Deleted At
deletedAt string

When deleted at.

Published At
publishedAt string

The published at.

Returns

Name Path Type Description
Template Path
content.templatePath string

The template path.

Plain Text Version
content.plainTextVersion string

The plain text version.

From
from.fromName string

The from name.

Reply To
from.replyTo string

The reply to.

Custom Reply To
from.customReplyTo string

The custom reply to.

ID
id string

The identifier.

Name
name string

The name.

Send On Publish
sendOnPublish boolean

Whether to send on publish.

State
state string

The state.

Subcategory
subcategory string

The subcategory.

Subject
subject string

The subject.

Include
to.contactLists.include array of string

The include array.

Exclude
to.contactLists.exclude array of string

The exclude array.

Include
to.contactIds.include array of string

The include array.

Exclude
to.contactIds.exclude array of string

The exclude array.

Limit Send Frequency
to.limitSendFrequency boolean

Whether to limit send frequency.

Suppress Graymail
to.suppressGraymail boolean

Whether to suppress graymail.

Created By ID
createdById string

The created by identifier.

Type
type string

The type.

Active Domain
activeDomain string

The active domain.

Archived
archived boolean

Whether archived.

Folder ID
folderId string

The folder identifier.

Feedback Survey ID
feedbackSurveyId string

The feedback survey identifier.

Test ID
testing.testId string

The test identifier.

Hours To Wait
testing.hoursToWait integer

The hours to wait.

AB Success Metric
testing.abSuccessMetric string

The A/B success metric.

AB Sample Size Default
testing.abSampleSizeDefault string

The A/B sample size default.

AB Status
testing.abStatus string

The A/B status.

AB Test Percentage
testing.abTestPercentage string

The A/B test percentage.

AB Sampling Default
testing.abSamplingDefault string

The A/B sampling default.

Subscription ID
subscriptionDetails.subscriptionId string

The subscription identifier.

Preferences Group ID
subscriptionDetails.preferencesGroupId string

The preferences group identifier.

Office Location ID
subscriptionDetails.officeLocationId string

The office location identifier.

Updated By ID
updatedById string

The updated by identifier.

Published By ID
publishedById string

The published by identifier.

Language
language string

The langauge.

Campaign
campaign string

The campaign.

Slug
webversion.slug string

The slug.

Domain
webversion.domain string

The domain.

Title
webversion.title string

The title.

Meta Description
webversion.metaDescription string

The meta description.

Redirect To URL
webversion.redirectToUrl string

The redirect to URL address.

Redirect To Page ID
webversion.redirectToPageId string

The redirect to page identifier.

Expires At
webversion.expiresAt string

When expires at.

Max Entries
rssData.maxEntries string

The max entries.

URL
rssData.url string

The URL address.

HubSpot Blog ID
rssData.hubspotBlogId string

The HubSpot blog identifier.

Blog Email Type
rssData.blogEmailType string

The blog email type.

Blog Image Max Width
rssData.blogImageMaxWidth string

The blog image max width.

Entry Template
rssData.rssEntryTemplate string

The entry template.

Use Headline As Subject
rssData.useHeadlineAsSubject boolean

Whether to use headline as subject.

Blog Layout
rssData.blogLayout string

The blog layout.

Is Transactional
isTransactional boolean

Whether is transactional.

Is Published
isPublished boolean

Whether is published.

Published Date
publishDate string

The published date.

Updated At
updatedAt string

When updated at.

Created At
createdAt string

When created at.

Deleted At
deletedAt string

When deleted at.

Published At
publishedAt string

The published at.

Definitions

string

This is the basic data type 'string'.