\n
\u00a0<\/P> For more information, please refer to the details below.\u00a0<\/P> \u00a0<\/P> Until now, our Campaigns API only supported a limited set of asset types (OBJECT_LIST, EXTERNAL_WEB_URL, and FORM) for reading and associating assets to campaigns.<\/P> \u00a0<\/P> We\u2019re now broadening our support to include many more asset types, reflecting the full range of content available in the Marketing Campaigns UI. This helps close the gap between what is available in the UI and what is accessible via the API.<\/P> Now Supported:<\/STRONG><\/P> We\u2019ll continue to expand asset type coverage over time in both the UI and the API, ensuring the API evolves alongside the platform to support more content types seamlessly.<\/P> \u00a0<\/P> We\u2019ve added new endpoints that allow you to create, read, update, and delete budget items on a campaign. This brings budget functionality closer to parity with what you can do in HubSpot.<\/P> New Endpoints:<\/STRONG><\/P> \u00a0<\/P> Similar to campaign budgets, you\u2019ll soon be able to manage campaign spend items via the API, allowing you to create, read, update, and delete spend items on a campaign.<\/P> New Endpoints:<\/STRONG><\/P> Important Note for Developers:<\/STRONG> With the introduction of these new endpoints, we\u2019re also enforcing scope group requirements for the Campaigns Public API to ensure proper access control. Any modification endpoint (such as create, update, and delete) will require the marketing.campaigns.write scope group<\/a>. This change applies to both the newly introduced endpoints for budget and spend management.\u00a0<\/P> \u00a0<\/P> The Campaigns API now supports both reading and updating the hs_utm property:<\/P> Example Request:<\/STRONG><\/P> When using the UTM property, UTM values must not exceed 256 characters. This validation helps ensure data consistency and avoids potential issues. The new support for the UTM property offers greater flexibility in setting UTM values, particularly if you wish to separate them from campaign names. If a value exceeds the 256-character limit, you\u2019ll encounter a validation error similar to this:<\/P><\/span><\/P>
\n
\n
\n
\nWhat’s changing?<\/H2>
\n\u00a0<\/H3>
\nSupport for More Asset Types<\/H3>
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n<\/UL>
\n
\n
\nCampaign Budget Management via Public API<\/H3>
\n
\n
\n
\n
\n
\n
\n
\n<\/UL>
\n
\nCampaign Spend Management via Public API<\/H3>
\n
\n
\n
\n
\n
\n
\n
\n<\/UL>
\n
\n
\nCustom UTM Property Support for Beta Users<\/H3>
\n
\n
\n
\n
\n<\/UL>
\n
\nPATCH \/campaigns\/{campaignGuid}
\n{
\n “properties”: {
\n “hs_name”: “Summer 2024 Campaign”,
\n “hs_utm”: “summer-promo-2024”
\n }
\n}
\n
\n{
\n “status”: “error”,
\n “message”: “Provided campaign UTM is longer than allowed. Max length: 256”,
\n “category”: “VALIDATION_ERROR”
\n}<\/p>\n