Please note: all calendar API endpoints are being sunset and are no longer supported. These APIs will no longer function, and data from the marketing calendar will no longer be available via API. These APIs will be removed on August 31, 2023.
Method Details
HTTP Methods:
POST
Content Type:
application/json
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
Marketing
Required Scope:
Create a new task for Calendar. Creating a task of type BLOG_POST, EMAIL, or LANDING_PAGE will create a draft of the respective content and associate it with the task, returning a contentId in the response.
By default, the createdBy user for the task will be automatically set as the User ID of the authenticated user. It is not possible to specify the createdBy user, only the ownerId of the calendar task. When specifying an owner, use the Owners API to get a list of owner Ids.
- Up to 10,000 tasks may be created over a 24 hour period per HubSpot account.
- This endpoint is for tasks on the Marketing calendar. For tasks associated with the CRM and CRM objects, please see the Engagements API