{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Update a campaign message.<br><br>*Rate limits*:<br>Burst: `10/s`<br>Steady: `150/m`\n\n**Scopes:**\n`campaigns:write`\n\n[OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/update_campaign_message.json)","properties":{"path":{"type":"object","properties":{"id":{"description":"The ID of the message","type":"string"}},"required":["id"],"additionalProperties":false},"query":{"type":"object","properties":{"fields[campaign-message]":{"type":"array","items":{"type":"string","enum":["created","definition","definition.ab_test","definition.ab_test.winner_metric","definition.ab_test.winner_percentage","definition.ab_test.winner_wait_hours","definition.name","definition.send_options","definition.send_options.is_ignoring_unsubscribes","definition.send_options.recipient_percentage","definition.send_options.send_strategy","definition.send_options.send_time","definition.send_options.send_times","definition.send_options.throttle_unit","definition.send_options.throttling_type","definition.status","definition.tracking_options","definition.tracking_options.is_add_utm","definition.tracking_options.is_tracking_clicks","definition.tracking_options.is_tracking_opens","definition.tracking_options.tracking_params","id","updated"]},"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/MessagePartialUpdateQuery"}},"required":["path","headers","body"],"additionalProperties":false,"definitions":{"MessagePartialUpdateQuery":{"type":"object","properties":{"data":{"$ref":"#/definitions/MessagePartialUpdateQueryResourceObject"}},"required":["data"]},"MessagePartialUpdateQueryResourceObject":{"type":"object","properties":{"type":{"$ref":"#/definitions/CampaignMessageEnum"},"id":{"description":"The ID of the message","type":"string"},"attributes":{"type":"object","properties":{"definition":{"$ref":"#/definitions/MessageDefinition"}}}},"required":["type","id","attributes"]},"CampaignMessageEnum":{"type":"string","enum":["campaign-message"]},"MessageDefinition":{"type":"object","properties":{"name":{"description":"The name of the message","type":["string","null"]},"status":{"description":"The status of the message","type":["string","null"],"enum":["cancelled","draft","scheduled","sending","sent"]},"tracking_options":{"$ref":"#/definitions/MessageTrackingOptions"},"send_options":{"$ref":"#/definitions/MessageSendOptions"},"ab_test":{"$ref":"#/definitions/ABTestSettings"}}},"MessageTrackingOptions":{"type":"object","properties":{"is_add_utm":{"type":["boolean","null"]},"is_tracking_clicks":{"type":["boolean","null"]},"is_tracking_opens":{"type":["boolean","null"]},"tracking_params":{"type":["array","null"],"items":{"oneOf":[{"$ref":"#/definitions/StaticMessageTrackingParam"},{"$ref":"#/definitions/DynamicMessageTrackingParam"}]}}}},"MessageSendOptions":{"type":"object","properties":{"send_time":{"description":"The UTC send time for this message","type":["string","null"],"format":"date-time","examples":["2022-11-08T00:00:00+00:00"]},"send_times":{"description":"Per-variation send times, keyed by variation ID. Populated for send-time optimization and AB send time test strategies.","type":["object","null"]},"send_strategy":{"description":"The scheduling strategy for this message.","type":["string","null"],"enum":["ab_send_time_test","content_variation","content_variation_local_timezone","local_timezone","personalized_send_time_optimization","send_time_optimization","static","throttled","variation_per_second_throttled"]},"recipient_percentage":{"description":"The percentage of recipients to send this message to","type":["integer","null"]},"throttling_type":{"description":"The throttling type for this message","type":["string","null"],"enum":["none","throttle-for-campaigns","throttle-for-campaigns-and-flows","throttle-for-flows"]},"throttle_unit":{"description":"The time unit each batch of recipients is sent over for throttled sends.","type":["string","null"],"enum":["hour","minute"]},"is_ignoring_unsubscribes":{"description":"Whether to ignore unsubscribes for this message","type":["boolean","null"]}}},"ABTestSettings":{"type":"object","properties":{"winner_metric":{"description":"The metric used to pick the winning variation.","type":["string","null"],"enum":["clicks_unique","opens_unique","placed_orders_unique"]},"winner_percentage":{"description":"The percentage of the audience that receives the winning variation. The remainder is split evenly across the variations under test.","type":["integer","null"]},"winner_wait_hours":{"description":"How long to collect results before picking a winner, in hours.","type":["integer","null"]}}},"StaticMessageTrackingParam":{"type":"object","properties":{"type":{"type":"string","default":"static","enum":["static"],"examples":["static"]},"name":{"type":"string"},"value":{"type":"string"}},"required":["name","value"]},"DynamicMessageTrackingParam":{"type":"object","properties":{"type":{"type":"string","default":"dynamic","enum":["dynamic"],"examples":["dynamic"]},"name":{"type":"string"},"value":{"type":"string"}},"required":["name","value"]}}},"name":"Update Campaign Message","id":"klaviyo.update_campaign_message","example":{"path":{"id":"example"},"headers":{"revision":"2026-10-15"},"body":{"data":{"type":"campaign-message","id":"example","attributes":{}}}},"maxRequests":1,"summary":false}}