Spend

Create spend item

Create a new campaign spend item for a specified campaign. This endpoint allows you to add financial details related to campaign expenditures, which can help in tracking and managing marketing budgets effectively.

post/marketing/campaigns/2026-09/{campaignGuid}/spend

Request

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

Path parameters

campaignGuidstring required

The unique identifier of the campaign for which the spend item is being created.

Request body

amountnumber required

The monetary value of the spend item, represented as a number.

descriptionstring

A string providing additional details or context about the spend item.

namestring required

The name of the spend item, represented as a string.

orderinteger required

An integer indicating the order or sequence of the spend item within a list.

Response

successful operation

amountnumber required

The financial amount associated with the spend item, represented as a number.

createdAtinteger required

A Unix timestamp in milliseconds indicating when the spend item was created.

descriptionstring

A string providing additional details about the spend item.

idstring required

The unique identifier for the spend item, represented as a string.

namestring required

The name of the spend item, represented as a string.

orderinteger required

An integer indicating the order or sequence of the spend item.

updatedAtinteger required

A Unix timestamp in milliseconds indicating when the spend item was last updated.

Changes

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