There's a new version of the HubSpot API

Starting November 30, 2022, API keys will be sunset as an authentication method. Learn more about this change and how to migrate an API key integration to use a private app instead.

Get Broadcast Messages

Last updated November 13, 2020

GET /broadcast/v1/broadcasts

Method Details

HTTP Methods:


Response Format:


Requires Authentication?


Rate Limited?






For a given portal, return details on a set of broadcast messages (e.g. a tweet or Facebook post).

A "broadcast" is a specific social message posted to a single social network.

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.
Optional Parameters How to use Description
Filter by status status=success - Query param Only include broadcasts in matching state (success, waiting, canceled, error_fatal)
Filter by created at since=1356036460644 Only include broadcasts created at or more recently than given timestamp (milliseconds from epoch)
Filter by channel withChannelKeys=Twitter:403551555 Only include broadcasts created on specific channels. To request multiple channels, include the withChannelKeys parameter multiple times
Limit number of results count=100 Only include specified number of results
Offset offset=100 Used to get the next set of results. Increment the offset by the number your using in the count parameter to get the next set of results.