---
title: "Select winning variant"
method: POST
path: "/api/v1/ab-tests/{id}/winner"
tags: ["A/B Testing"]
---

# Select winning variant

`POST /api/v1/ab-tests/{id}/winner`

## Request

- Base URL: `https://api.misar.io/mail`
- URL: `https://api.misar.io/mail/api/v1/ab-tests/{id}/winner`
- Auth: HTTP bearer

Manually select the winning A/B test variant. The winning content is applied to the parent campaign.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `winner_variant` string, required
  - `metric` 'opens' | 'clicks' | 'revenue' | 'conversions'

## Response `200`

Winner selected and applied to campaign

- object
  - `success` boolean
  - `data` object
    - `ab_test_id` string, uuid
    - `campaign_id` string, uuid
    - `winner_variant` string
    - `metric` string
    - `winner_selected_at` string, date-time
    - `applied_to_campaign` object
      - `subject` string
      - `body_html` string
      - `from_name` string

## Other responses

- `400`: Validation error
- `401`: Invalid API key
- `403`: Insufficient scope
- `404`: A/B test not found
- `409`: Winner already selected

---

[API](https://skmtc.dev/misar/apis/misarmail-api.md) · [All operations](https://skmtc.dev/misar/apis/misarmail-api/llms.txt) · [OpenAPI document](https://skmtc.dev/misar/apis/misarmail-api/revisions/1141238bc092?raw)