That is correct. Our Marketing Email APIs only support Getting, Creating, Updating, Deleting emails at present. If you wish to send emails programmatically we do offer a Single Send API that is part of our Transactional Email API. However in order to use this API you would require the Transactional Email Add-on.
I agree with you entirely. I've worked on our services team helping customers implement HubSpot for the past 3 years and this does come up a lot. Our team is actively aware of this and I can say that we're looking at introducing this type of functionality into our Marketing Emails API. However I can't provide an ETA on this.
So in short it is technically possible to publish emails via the API but this is part of our single send API which requires our transactional email add on to access. We're actively looking at introducing similar functionality into our Marketing email APIs.
I should have gone into more depth with regards the single send functionality. The single send api is not reserved for transactional email. It is entirely possible to set it up to include marketing emails. It is just that it requires transactional email in order to access.
For example its possible to create an email from within the hubspot UI, set a subscription type and enable footer information for unsubscribes and save for single send.
If you attempt to send an email to a contact that is unsubscribed the email wont be sent and an error message will be returned.
I'll of course ensure appropriate team are aware of your issues. They are already actively working on functionality like this.
How do I create and send emails to a contact list using the api?
I totally understand that part of the API. What it doesn't do AFAIK is send to a contact list.
It can only work if you have the contact(s) email address(es). But what I want is to be able to specify say the list ID(s) to send a marketing email to.
In a higher lever, I want to do something like: Hey API, here's an email I want you to send to all contact in this list.