There's a new version of the HubSpot API

We're also working on a new documentation website, you're invited to check it out and give us your feedback.

Get a Page by ID

Last updated May 31, 2023

GET /content/api/v2/pages/:page_id

Method Details

HTTP Methods:

GET

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

Marketing

Get the details for a specific page.

Required Parameters How to use Description
OAuth access token or private app access token Authorization: Bearer {token} header Used to authenticate the request. Please see this page for more details about authentication.
page_id Used in the request URL Unique identifier for a particular blog

JSON Fields returned in the response

Parameter name Type Description
ab_status string An enum with the status of the A/B test - either "master", "variant" or "loser_variant"
ab_test_id string If this page is an A/B test, this is the unique id for the test. The master, the active variants, and the loser variants, will all have the same ab_test_id
archived_at long When the page was deleted, in milliseconds since the epoch. Zero if the page was never deleted. Use a DELETE request to delete the page, do not set this directly.
archivedinDashboard bool If True, the page will not show up in your dashboard, although the page will still be live
campaign string The guid of the marketing campaign this page is associated with
campaign_name string The name of the marketing campaign this page is associated with
created long When the page was first created, in milliseconds since the epoch
footer_html string Custom HTML for embed codes, javascript that should be placed before the </body> tag of the page
head_html string Custom HTML for embed codes, javascript, etc. that goes in the <head> tag of the page
id string The unique id of the topic
is_draft string True if the post is still a draft, invisible to the public. Gets changed when the /publish-action API endpoint is called
meta_description string A description that goes in <meta> tag on the page
meta_keywords string Keywords for the meta tag
name string The internal name of the page
password string Set this to create a password protected page. Entering the password will be required to view the page
publish_date long The date the page is to be published at in milliseconds since the unix epoch.
publish_immediately string Set this to true if you want to be published immediately when the schedule publish endpoint is called, and to ignore the publish_date setting
slug string The path of the URL on which the page will live. Changing this will change the URL.
style_override_id string The ID of the style to use for this page, set this to use a different style than the default style for the site
subcategory string This is set to empty or to "landing_page" for landing pages, or to "site_page" for site pages
updated long When the page was last updated, in milliseconds since the epoch
url string The full URL with domain and scheme to the page. Will return a 404 if the page is not yet published.
widget_containers string A data structure containing the data for all the modules inside the containers for this post. This will only be populated if the page has widget containers.
widgets string A data structure containing the data for all the modules for this page.