Are Marketing Email APIs available in Free, Starter & Pro accounts?

Developer Support APIs & Integrations
, , , ,
1

I am trying to develop an API integration through a Public or Private app (undecided) with the purpose of creating and sending marketing emails in one action.

I am confused by the restrictions on certain functions that would enable Marketing email sending:

  • Single Send API clearly states that “Marketing Hub - Enterprise”(or higher) is required, both in the API Endpoint docs - Supported Products and the API Guide - Requirements
  • Marketing Emails API has conflicting information
    • API Guide shows “Marketing Hub - Free” or above in Supported Products section
    • However the Marketing Email API Guide calls out that the “/publish” and “/unpublish” endpoints must have “Marketing Hub - Enterprise” or transactional email add-on

Can someone please confirm if we should be able to do the full email lifecycle via the API when on Marketing Hub - ANY tier (Free, Starter, Pro, Enterprise). Both the Create (POST /marketing/v3/emails/) and the Publish (POST /marketing/v3/emails/{emailId}/publish).

My overall goal is to setup an Email and send it right away - not future scheduling - regardless of product tier. Is there another way to just create + send in one command that would avoid the gated Publish API?

2

Hey, @TBZ_LH :waving_hand: Thanks for your question.

  • If you want to send marketing emails through an API in one step, you would need:
    Marketing Hub Enterprise for the Single Send Marketing Email API
    OR
  • Marketing Hub Enterprise plus the additional transactional email add-on if you want to use both marketing and transactional APIs

There is no API option on Free, Starter, or Professional tiers that would allow you to create and send marketing emails in one action without upgrading to Enterprise.

Best,

Jaycee

3

Hi @Jaycee_Lewis (or anyone!)

Thanks for your response. To be clear - whether sending is done in one command or multiple is not important. What’s important is being able to send marketing mail (newsletters) through the API - without account tier / package restrictions.

For example, I was originally planning on triggering these API calls

  1. Create template (POST /content/api/v2/templates)
  2. Create marketing email with existing Template (POST /marketing/v3/emails/)
  3. Publish the marketing email created in step #2 (POST /marketing/v3/emails/emailId/publish)

It seems that I can do step 1 & #2 on any account tier (Marketing Hub Free, Starter, Pro, Enterprise), but as far as documentation step #3 requires minimum Enterprise tier.

My questions:

  • Is my understanding correct that /publish, #3 (above) is ONLY for Enterprise (the highest tier)?
  • Is there any other way to send marketing emails through the API? Either a different path, or even the same path just without using the #3 publish endpoint?
    • Wishful thinking - The #2 Create marketing email API has a lot of options in the request body - like “sendOnPublish”, “state” or “publishDate” -
      Reading the documentation it almost sounds like you could set “publishDate” to a datetime in the future and “sendOnPublish” to true on the #2 Create marketing email API. Then once the datetime passes, it would automatically be in a “published” state, and it would auto send because of “sendOnPublish”.
  • (Purely out of curiosity, why would all the APIs function for all tiers, other than the last one in the chain?)

Any suggestion / way forward that would help me be able to send marketing emails - through API - WITHOUT Enterprise package restrictions would be greatly appreciated.

Thanks!