HUhubspot
Budget

Add budget item

Add a new budget item to the specified campaign. This endpoint allows you to associate financial allocations with a campaign, enabling better tracking and management of campaign budgets.

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

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/marketing/campaigns/2026-09/{campaignGuid}/budget
  • 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 to which the budget item will be added.

Request body

amountnumber required

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

descriptionstring

A string providing additional details about the budget item.

namestring required

The name of the budget item. It is a string that identifies the budget item.

orderinteger required

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

Response

successful operation

amountnumber required

The financial amount allocated to this budget item, represented as a number.

createdAtinteger required

A Unix timestamp in milliseconds indicating when this budget item was created.

descriptionstring

A description of the budget item, represented as a string.

idstring required

The unique identifier for this budget item, represented as a string.

namestring required

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

orderinteger required

An integer representing the order or sequence of this budget item within the campaign.

updatedAtinteger required

A Unix timestamp in milliseconds indicating when this budget item was last updated.

Changes

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