HubSpot Marketing API
A practical OpenAPI 3.1 definition for HubSpot CRM contacts, marketing campaigns, and marketing email retrieval using the current stable date-versioned API paths.
Connect this API to an AI agent Browse all specs
What you can do with HubSpot Marketing API via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| GET | /crm/objects/2026-03/contacts |
getCrmObjects202603Contacts | List contacts Method: GET Path: /crm/objects/2026-03/contacts IMPORTANT: This function has 0 REQUIRED parameter(s) and 3 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - limit: limit parameter. - after: after parameter. - properties: Comma-separated contact properties. |
| GET | /crm/objects/2026-03/contacts/{contactId} |
getCrmObjects202603ContactsByContactid | Get a contact Method: GET Path: /crm/objects/2026-03/contacts/{contactId} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - contactId: contactId parameter. |
| POST | /crm/objects/2026-03/contacts/search |
postCrmObjects202603ContactsSearch | Search contacts Method: POST Path: /crm/objects/2026-03/contacts/search IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Request Body: REQUIRED: - body: Request body (application/json) |
| GET | /marketing/campaigns/2026-03 |
getMarketingCampaigns202603 | List campaigns Method: GET Path: /marketing/campaigns/2026-03 |
| GET | /marketing/campaigns/2026-03/{campaignGuid} |
getMarketingCampaigns202603ByCampaignguid | Get a campaign Method: GET Path: /marketing/campaigns/2026-03/{campaignGuid} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - campaignGuid: campaignGuid parameter. |
| GET | /marketing/emails/2026-03 |
getMarketingEmails202603 | List marketing emails Method: GET Path: /marketing/emails/2026-03 IMPORTANT: This function has 0 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - limit: limit parameter. - after: after parameter. |
| GET | /marketing/emails/2026-03/{emailId} |
getMarketingEmails202603ByEmailid | Get a marketing email Method: GET Path: /marketing/emails/2026-03/{emailId} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - emailId: emailId parameter. |
Usage guide
## HubSpot Marketing API This listing describes documented production API routes only. Before making requests, read the provider's official documentation and configure the server URL variables where applicable. ### Authentication Create a HubSpot private app for a controlled account or an OAuth app for multiple accounts. Send the access token as `Authorization: Bearer YOUR_ACCESS_TOKEN`. Request only the scopes needed by the selected CRM or marketing endpoints. ### Operational guidance Use pagination for collection endpoints, respect provider rate limits, validate identifiers before mutating resources, and follow each provider's terms, consent requirements, and data-retention policies.
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “HubSpot Marketing API” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.