HubSpot Pages

Name: Pages API
Brand: Pages
Availability: InStock

✓ Official Vendor SpecMarketingContent Managementoauth2, apiKey66 EndpointsREST

For Agents

Create, update, schedule, A/B test, and translate HubSpot Site Pages and Landing Pages, with full revision and folder management for agentic publishing flows.

Install Jentic One Beta

Connect the Pages to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Pages, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Pages API.

Create or update Site Pages and Landing Pages individually or in batch

Schedule a page to publish at a specific timestamp via the schedule endpoint

Manage page drafts and push the draft version live in one call

Roll a page back to an earlier revision or restore a revision into draft

GET STARTED

Start building with Pages API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Pages API for, with concrete tasks.

★ Programmatic Landing Page Production

Marketing teams running many concurrent campaigns build landing pages from templates rather than from scratch. The Pages API exposes a batch create endpoint plus folder management, letting an integration spin up dozens of campaign landing pages in one orchestrated run. Each new page can be scheduled and attached to a folder for clean reporting.

POST 25 page payloads to /cms/v3/pages/landing-pages in a batch, attach them all to folder 'Q4-Campaign' via /cms/v3/pages/landing-pages/folders/batch/create, and schedule each via /cms/v3/pages/landing-pages/{objectId}/draft and the schedule endpoint.

Multi-Language Page Publishing

Brands launching campaigns in several languages need each translation tied to the source page so reporting rolls up cleanly. The multi-language endpoints attach pages to a language group, set a primary, and update language assignments — keeping a single conceptual page across locales rather than disconnected duplicates.

POST to /cms/v3/pages/site-pages/multi-language/attach-to-lang-group with the source page ID and the translated page IDs, then call set-new-lang-primary if the primary language has changed.

A/B Test Lifecycle Automation

Conversion-rate teams run a constant cadence of A/B tests on landing pages. Using the ab-test endpoints, an agent can launch a test, monitor results via revision endpoints, and call the ab-test/end endpoint to crown the winner — all without entering the HubSpot UI. The result is a reproducible experimentation loop.

After 7 days of traffic, POST to /cms/v3/pages/site-pages/ab-test/end with the winning variant, then update any campaign reporting to reflect the winning page.

Pre-Publish Revision Audit

Before a major page goes live, an editor wants to confirm exactly what changed since the last published version. The revisions endpoints return the change history and a specific revision payload so the agent can render a diff for human approval, then push the draft live or restore a prior revision if rejected.

GET /cms/v3/pages/site-pages/{objectId}/revisions, fetch the latest two revisions, render a side-by-side diff for the reviewer, and either push the draft live or POST to the restore endpoint.

Agent-Driven Page Publishing

An AI agent handed a brief plus brand assets needs to produce a live landing page end-to-end. Through Jentic, the agent searches for the create-landing-page operation, loads the schema, and executes it; subsequent calls schedule the page, attach it to a folder, and push the draft live. Credentials never leave the Jentic vault.

Use Jentic to search 'create hubspot landing page', load the schema, execute it with the brief, then call the draft push-live endpoint to bring the page online.

Key Endpoints

66 endpoints — the hubspot cms pages api manages site pages and landing pages — the two primary marketing page types in hubspot's cms.

METHOD

PATH

DESCRIPTION

POST

/cms/v3/pages/landing-pages

Create a landing page

POST

/cms/v3/pages/site-pages/batch/update

Update site pages in batch

POST

/cms/v3/pages/site-pages/schedule

Schedule a site page to publish

POST

/cms/v3/pages/site-pages/ab-test/end

End an A/B test on a site page

GET

/cms/v3/pages/site-pages/{objectId}/revisions

List revisions of a site page

POST

/cms/v3/pages/landing-pages/{objectId}/draft

Update the draft of a landing page

POST

/cms/v3/pages/site-pages/multi-language/attach-to-lang-group

Attach a page to a language group

POST

/cms/v3/pages/landing-pages/folders/batch/create

Create landing page folders in batch

POST

/cms/v3/pages/landing-pages

Create a landing page

POST

/cms/v3/pages/site-pages/batch/update

Update site pages in batch

POST

/cms/v3/pages/site-pages/schedule

Schedule a site page to publish

POST

/cms/v3/pages/site-pages/ab-test/end

End an A/B test on a site page

GET

/cms/v3/pages/site-pages/{objectId}/revisions

List revisions of a site page

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

HubSpot OAuth tokens and Private App keys live in the Jentic encrypted vault (MAXsystem). Agents only ever hold a scoped execution token, so the underlying HubSpot secret stays out of model context.

Intent-based discovery

Agents search Jentic with intents like 'create hubspot landing page' or 'schedule hubspot site page' and receive the matching operation along with a ready-to-fill input schema.

Time to first call

Direct integration: 3-5 days to wire OAuth, batch creates, scheduling, drafts, and A/B test endpoints. Through Jentic: under a day to search, load, and execute each operation.

FAQs

Specific to using Pages API through Jentic.

What authentication does the HubSpot CMS Pages API use?

It accepts HubSpot OAuth 2.0 tokens or Private App tokens in the Authorization header with the content scope. Jentic stores those credentials in its encrypted vault and gives the agent only a scoped execution token at call time.

Can I create both Site Pages and Landing Pages with this API?

Yes. Site Pages are managed under /cms/v3/pages/site-pages and Landing Pages under /cms/v3/pages/landing-pages, with parallel endpoints for each type. They share the revision and multi-language patterns but maintain separate object records.

What are the rate limits for the HubSpot Pages API?

It uses HubSpot's standard public API caps: 100 requests per 10 seconds for OAuth apps and 110 per 10 seconds for Private Apps on Pro and Enterprise. The batch endpoints help large publishing jobs stay under the limit.

How do I schedule a landing page to publish through Jentic?

Run pip install jentic, search 'schedule hubspot landing page', load the schema, and execute it with the page ID and target timestamp. Jentic posts to the schedule endpoint with the right auth headers.

Does the Pages API let me upload page templates?

No. Templates and modules are managed by the CMS Source Code API. The Pages API consumes templates (by template path or ID) but does not create or upload them.

Can I run an A/B test entirely through the API?

Yes. The site-pages namespace exposes ab-test/end and complementary endpoints to manage test variants. Combine with revisions to track the winning variant before formally ending the test.

HubSpot Pages

Connect the Pages to your agent

Capabilities

Start building with Pages API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs