Basic

Retrieve campaigns

Retrieve a page of marketing campaigns from your HubSpot account. This endpoint allows you to sort, filter, and paginate through campaigns, making it useful for managing and analyzing your marketing efforts.

get/marketing/campaigns/2026-09

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/marketing/campaigns/2026-09
  • Auth
    OAuth 2
    Authorization code: https://app.hubspot.com/oauth/authorize
    Token URL: https://api.hubapi.com/oauth/v1/token scopes: marketing.campaigns.read

Query parameters

afterstring

A cursor token for pagination. Use the value from the previous response's paging.next.after field.

limitinteger

The maximum number of results to display per page.

namestring

A string to filter campaigns by name.

propertiesstring[]

An array of property names to include in the response.

sortstring

A string to specify the sorting order of the results.

Response

successful operation

totalinteger required

An integer representing the total number of campaigns available.

Changes

No recorded changes to this operation across all 5 revisions of this API.