There's a new version of the HubSpot API

As of November 30, 2022, HubSpot API Keys are being deprecated and are no longer supported. Continued use of HubSpot API Keys is a security risk to your account and data. Your API Keys could be deactivated at any time after Nov. 30th, and we recommend that you migrate to Private Apps as soon as possible so you do not lose business-critical functionality.

Create a Broadcast Message

Last updated June 17, 2020

POST /broadcast/v1/broadcasts

Method Details

HTTP Methods:


Content Type:


Response Format:


Requires Authentication?


Rate Limited?






Create a new broadcast message (e.g. a tweet or Facebook post) to be published. It can be scheduled immediately or at a time in the future.

Required Parameters How to use Description
OAuth Access Token or API Key Authorization: Bearer {token} header
or hapikey={key} query parameter.
Used to authenticate the request. Please see this page for more details about authentication.
Channel GUID "channelGuid": {guid}
used in the request body
The GUID of the publishing channel that the message is for. You can get all of the channels for a portal using this endpoint.
Optional Parameters How to use Description
Trigger At "triggerAt": {timestamp}
used in the request body
A Unix timestamp in milliseconds of the time that the message should be published to the channel. If this is not included in the request, the message will be published immediately.
Create a draft message "status": "DRAFT"
used in the request body
Create the message as a draft, meaning that it will not be scheduled to publish and can be reviewed and scheduled from within the HubSpot Social Media Publishing app. Note: If the draft status is set, any triggerAt value will be unset.