{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Schedule a single 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/schedule_campaign_message.json)","properties":{"query":{"type":"object","properties":{"fields[campaign-message-schedule]":{"type":"array","items":{"type":"string","enum":["id","send_date","send_time","strategy","throttle_unit","throttling_percentage"]},"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/CampaignMessageScheduleQuery"}},"required":["headers","body"],"additionalProperties":false,"definitions":{"CampaignMessageScheduleQuery":{"type":"object","properties":{"data":{"$ref":"#/definitions/CampaignMessageScheduleQueryResourceObject"}},"required":["data"]},"CampaignMessageScheduleQueryResourceObject":{"type":"object","properties":{"type":{"$ref":"#/definitions/CampaignMessageScheduleEnum"},"attributes":{"type":"object","properties":{"send_time":{"description":"The datetime at which the message should be sent (must be in the future). Required when strategy is not 'smart_send_time'.","type":["string","null"],"format":"date-time","examples":["2026-08-01T14:30:00+00:00"]},"send_date":{"description":"The date on which the message should be sent. Required when strategy is 'smart_send_time'. Must not be in the past.","type":["string","null"],"format":"date","examples":["2026-08-01"]},"strategy":{"description":"The send strategy to use: static, local_timezone, throttled, or smart_send_time","type":"string","enum":["local_timezone","smart_send_time","static","throttled"],"examples":["static"]},"throttled_options":{"$ref":"#/definitions/ThrottledOptions"},"timezone_options":{"$ref":"#/definitions/TimezoneOptions"}},"required":["strategy"]},"relationships":{"type":"object","properties":{"campaign-message":{"type":"object","properties":{"data":{"type":"object","properties":{"type":{"$ref":"#/definitions/CampaignMessageEnum"},"id":{"description":"The campaign message to schedule","type":"string"}},"required":["type","id"]}}}},"required":["campaign-message"]}},"required":["type","attributes","relationships"]},"CampaignMessageScheduleEnum":{"type":"string","enum":["campaign-message-schedule"]},"ThrottledOptions":{"type":"object","properties":{"throttling_percentage":{"description":"Percentage of recipients to send to per throttle unit (1, 2, 5, 10, 11, 13, 14, 17, 20, 25, 33, or 50)","type":"integer","examples":[20]},"throttle_unit":{"description":"The time unit each batch of recipients is sent over: 'hour' or 'minute'.","type":"string","default":"hour","enum":["hour","minute"],"examples":["hour"]}},"required":["throttling_percentage"]},"TimezoneOptions":{"type":"object","properties":{"send_past_timezones_tomorrow":{"description":"If true, recipients in timezones where the send time has already passed will receive the message the following day. If false, they receive it immediately.","type":["boolean","null"],"default":false}}},"CampaignMessageEnum":{"type":"string","enum":["campaign-message"]}}},"name":"Schedule Campaign Message","id":"klaviyo.schedule_campaign_message","example":{"headers":{"revision":"2026-10-15"},"body":{"data":{"type":"campaign-message-schedule","attributes":{"strategy":"static"},"relationships":{"campaign-message":{}}}}},"maxRequests":1,"summary":false}}