launch_test
launch_test randomly assigns recipients to subject line variants, sends the
campaign through marginal's hosted delivery layer, and records a tracking token per message for
opens and clicks. Returns an experiment_id for later analysis.
When to use it
- Running a subject line A/B or A/B/C test from an agent workflow
- Programmatic email experiments without wiring Mailchimp or Klaviyo APIs
- Cart recovery, launch promos, or lifecycle tests to a CSV-style recipient list
Example
{
"variants": [
{ "variant_text": "Your cart is waiting" },
{ "variant_text": "Still thinking about it?" },
{ "variant_text": "20% off ends tonight" }
],
"recipients": [
{ "email": "[email protected]", "name": "You" }
],
"winner_criteria": "clicks",
"destination_url": "https://yourstore.com/cart"
}
Response
Save experiment_id from the tool result, then call
get_results after engagement accumulates.