{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Update the UTM tracking setting with the given account ID.\n\nMore information about UTM tracking settings can be found [here](https://help.klaviyo.com/hc/en-us/articles/115005247808).<br><br>*Rate limits*:<br>Burst: `10/s`<br>Steady: `150/m`\n\n**Scopes:**\n`tracking-settings:write`\n\n[OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/update_tracking_setting.json)","properties":{"path":{"type":"object","properties":{"id":{"description":"The id of the tracking setting (account ID).","type":"string"}},"required":["id"],"additionalProperties":false},"query":{"type":"object","properties":{"fields[tracking-setting]":{"type":"array","items":{"type":"string","enum":["auto_add_parameters","custom_parameters","id","utm_campaign","utm_campaign.campaign","utm_campaign.campaign.type","utm_campaign.campaign.value","utm_campaign.flow","utm_campaign.flow.type","utm_campaign.flow.value","utm_id","utm_id.campaign","utm_id.campaign.type","utm_id.campaign.value","utm_id.flow","utm_id.flow.type","utm_id.flow.value","utm_medium","utm_medium.campaign","utm_medium.campaign.type","utm_medium.campaign.value","utm_medium.flow","utm_medium.flow.type","utm_medium.flow.value","utm_source","utm_source.campaign","utm_source.campaign.type","utm_source.campaign.value","utm_source.flow","utm_source.flow.type","utm_source.flow.value","utm_term","utm_term.campaign","utm_term.campaign.type","utm_term.campaign.value","utm_term.flow","utm_term.flow.type","utm_term.flow.value"]},"description":"For more information please visit https://developers.klaviyo.com/en/v2026-10-15/reference/api-overview#sparse-fieldsets"}},"required":[],"additionalProperties":false},"headers":{"type":"object","properties":{"revision":{"type":"string","default":"2026-10-15","enum":["2026-10-15"],"description":"API endpoint revision (format: YYYY-MM-DD[.suffix])"}},"required":["revision"],"additionalProperties":false},"body":{"$ref":"#/definitions/TrackingSettingPartialUpdateQuery"}},"required":["path","headers","body"],"additionalProperties":false,"definitions":{"TrackingSettingPartialUpdateQuery":{"type":"object","properties":{"data":{"$ref":"#/definitions/TrackingSettingPartialUpdateQueryResourceObject"}},"required":["data"]},"TrackingSettingPartialUpdateQueryResourceObject":{"type":"object","properties":{"type":{"$ref":"#/definitions/TrackingSettingEnum"},"id":{"description":"The id of the tracking setting (account ID).","type":"string"},"attributes":{"type":"object","properties":{"auto_add_parameters":{"description":"Whether tracking parameters are automatically added to campaigns and flows.","type":["boolean","null"]},"utm_source":{"$ref":"#/definitions/TrackingParamDTO"},"utm_medium":{"$ref":"#/definitions/TrackingParamDTO"},"utm_campaign":{"$ref":"#/definitions/TrackingParamDTO"},"utm_id":{"$ref":"#/definitions/TrackingParamDTO"},"utm_term":{"$ref":"#/definitions/TrackingParamDTO"},"custom_parameters":{"description":"List of custom tracking parameters.","type":["array","null"],"items":{"$ref":"#/definitions/CustomTrackingParamDTO"}}}}},"required":["type","id","attributes"]},"TrackingSettingEnum":{"type":"string","enum":["tracking-setting"]},"TrackingParamDTO":{"type":"object","properties":{"flow":{"description":"The value of the tracking parameter when applied to a flow.","oneOf":[{"$ref":"#/definitions/FlowTrackingSettingDynamicParam"},{"$ref":"#/definitions/FlowTrackingSettingStaticParam"}]},"campaign":{"description":"The value of the tracking parameter when applied to a campaign.","oneOf":[{"$ref":"#/definitions/CampaignTrackingSettingDynamicParam"},{"$ref":"#/definitions/CampaignTrackingSettingStaticParam"}]}}},"CustomTrackingParamDTO":{"type":"object","properties":{"flow":{"description":"The value of the tracking parameter when applied to a flow.","oneOf":[{"$ref":"#/definitions/FlowTrackingSettingDynamicParam"},{"$ref":"#/definitions/FlowTrackingSettingStaticParam"}]},"campaign":{"description":"The value of the tracking parameter when applied to a campaign.","oneOf":[{"$ref":"#/definitions/CampaignTrackingSettingDynamicParam"},{"$ref":"#/definitions/CampaignTrackingSettingStaticParam"}]},"name":{"description":"The name of the custom tracking parameter","type":"string"}},"required":["name"]},"FlowTrackingSettingDynamicParam":{"type":"object","properties":{"type":{"description":"The type of the tracking parameter","type":"string","enum":["dynamic"]},"value":{"description":"The value of the tracking parameter","type":"string","enum":["email_subject","flow_id","flow_name","link_alt_text","message_name","message_name_id","message_type","profile_external_id","profile_id"]}},"required":["type","value"]},"FlowTrackingSettingStaticParam":{"type":"object","properties":{"type":{"description":"The type of the tracking parameter","type":"string","enum":["static"]},"value":{"description":"The value of the tracking parameter","type":"string"}},"required":["type","value"]},"CampaignTrackingSettingDynamicParam":{"type":"object","properties":{"type":{"description":"The type of the tracking parameter","type":"string","enum":["dynamic"]},"value":{"description":"The value of the tracking parameter","type":"string","enum":["campaign_id","campaign_name","campaign_name_id","campaign_name_send_day","email_subject","group_id","group_name","group_name_id","link_alt_text","message_type","profile_external_id","profile_id","variation_name"]}},"required":["type","value"]},"CampaignTrackingSettingStaticParam":{"type":"object","properties":{"type":{"description":"The type of the tracking parameter","type":"string","enum":["static"]},"value":{"description":"The value of the tracking parameter","type":"string"}},"required":["type","value"]}}},"name":"Update Tracking Setting","id":"klaviyo.update_tracking_setting","example":{"path":{"id":"example"},"headers":{"revision":"2026-10-15"},"body":{"data":{"type":"tracking-setting","id":"example","attributes":{}}}},"maxRequests":1,"summary":false}}