> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt > Use this file to discover all available pages before exploring further. --- id: 3c6d60db-be9c-402d-a21e-83c0186beee9 --- # Update budget item > Update a specific budget item by ID within a marketing campaign. This endpoint allows you to modify the details of a budget item associated with a campaign, identified by its unique campaignGuid and budgetId. Use this to adjust budget allocations or update budget-related information for a campaign. > [accordion] Supported products > [accordion] Required Scopes ## OpenAPI ````yaml specs/2026-09/marketing-campaigns-public-api-v2026-09.json PUT /marketing/campaigns/2026-09/{campaignGuid}/budget/{budgetId} openapi: 3.0.1 info: title: Marketing Campaigns Public Api description: Basepom for all HubSpot Projects version: 2026-09 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE servers: - url: https://api.hubapi.com security: [] tags: - name: Advanced - name: Assets - name: Basic - name: Batch - name: Budget - name: Reports - name: Spend paths: /marketing/campaigns/2026-09/{campaignGuid}/budget/{budgetId}: put: tags: - Budget summary: Update budget item description: >- Update a specific budget item by ID within a marketing campaign. This endpoint allows you to modify the details of a budget item associated with a campaign, identified by its unique campaignGuid and budgetId. Use this to adjust budget allocations or update budget-related information for a campaign. operationId: put-/marketing/campaigns/2026-09/{campaignGuid}/budget/{budgetId} parameters: - name: budgetId in: path description: The unique identifier of the budget item to update. required: true style: simple explode: false schema: type: integer format: int64 - name: campaignGuid in: path description: The unique identifier of the campaign. required: true style: simple explode: false schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/PublicBudgetItemInput' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/PublicBudgetItem' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - marketing.campaigns.write components: schemas: PublicBudgetItemInput: required: - amount - name - order type: object properties: amount: type: number description: The monetary value of the budget item, represented as a number. description: type: string description: A string providing additional details about the budget item. name: type: string description: >- The name of the budget item. It is a string that identifies the budget item. order: type: integer description: An integer indicating the order or sequence of the budget item. format: int32 PublicBudgetItem: required: - amount - createdAt - id - name - order - updatedAt type: object properties: amount: type: number description: >- The financial amount allocated to this budget item, represented as a number. createdAt: type: integer description: >- A Unix timestamp in milliseconds indicating when this budget item was created. format: int64 description: type: string description: A description of the budget item, represented as a string. id: type: string description: The unique identifier for this budget item, represented as a string. name: type: string description: The name of the budget item, represented as a string. order: type: integer description: >- An integer representing the order or sequence of this budget item within the campaign. format: int32 updatedAt: type: integer description: >- A Unix timestamp in milliseconds indicating when this budget item was last updated. format: int64 Error: required: - category - correlationId - message type: object properties: category: type: string description: The error category, represented as a string. context: type: object additionalProperties: type: array items: type: string description: >- An object providing context about the error condition, where each key is a string and each value is an array of strings. example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- A unique identifier for the request, formatted as a UUID. This should be included with any error reports or support tickets. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: >- An array providing further information about the error, with each item being an ErrorDetail object. items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- A map of link names to associated URIs containing documentation about the error or recommended remediation steps, represented as an object with string values. message: type: string description: >- A human readable message describing the error along with remediation steps where appropriate. It is a string. example: An error occurred subCategory: type: string description: >- A specific category that contains more specific detail about the error, represented as a string. description: >- Represents an error response returned by the API when an operation fails. This component is used in various endpoints to provide detailed information about the error encountered. example: message: Invalid input (details will vary based on the error) correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf category: VALIDATION_ERROR links: knowledge-base: https://www.hubspot.com/products/service/knowledge-base ErrorDetail: required: - message type: object properties: code: type: string description: The status code associated with the error detail. This is a string. context: type: object additionalProperties: type: array items: type: string description: >- Context about the error condition, provided as an object where each key is a context name and the value is an array of strings providing additional information. example: '{missingScopes=[scope1, scope2]}' in: type: string description: >- The name of the field or parameter in which the error was found. This is a string. message: type: string description: >- A human readable message describing the error along with remediation steps where appropriate. This is a string. subCategory: type: string description: >- A specific category that contains more specific detail about the error. This is a string. description: >- Represents detailed information about an error that occurred in the API. This component is used to provide additional context and specifics about errors, typically as part of an error response. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hubspot.com/oauth/authorize tokenUrl: https://api.hubapi.com/oauth/v1/token scopes: marketing.campaigns.read: '' marketing.campaigns.revenue.full.read: '' marketing.campaigns.revenue.lite.read: '' marketing.campaigns.revenue.read: '' marketing.campaigns.write: '' ````