Sign in
A/B Tests

Create A/B test

Creates a draft campaign A/B test or converts a sequence email node to action_ab_test. Provide exactly one owner. Variant A is copied into an independent email for sequences; sequence conversions require at least one extra variant.

post/ab-tests

Request body

campaignIdstring

Campaign to attach the test to. Must be in draft or rejected status. Mutually exclusive with automationNodeId.

automationNodeIdstring

Sequence action_email node to convert. Mutually exclusive with campaignId.

confirmLiveChangeboolean

Must be true when converting an email node in an active sequence.

namestring

Test name. Defaults to "A/B Test for <campaign name>".

testPercentageinteger

Share of the audience that receives test sends.

testDurationMinutesinteger

How long the test phase runs before a winner is selected.

winnerCriteria'open_rate' | 'click_rate'

Metric used to pick the winner.

testType'subject' | 'content'

Sequence test type. Subject uses open_rate; content uses click_rate.

winnerThresholdinteger

Number of sequence recipients in the test sample.

Example request

{
  "variants": [
    {
      "blocks": [
        {
          "id": "block_123",
          "type": "html",
          "content": "<h1>Hello</h1>",
          "styles": {
            "backgroundColor": "#f8fafc",
            "backgroundOpacity": 80,
            "textColor": "#111827",
            "borderRadius": 12,
            "borderColor": "#cbd5e1",
            "borderWidth": 1
          },
          "conditions": [
            {
              "id": "c1",
              "value": "plan:pro"
            }
          ]
        }
      ]
    }
  ]
}

Response

A/B test created

successboolean

Example response

{
  "success": true,
  "abTest": {
    "id": "ab_abc123",
    "companyId": "company_abc123",
    "campaignId": "camp_abc123",
    "automationNodeId": "node_abc123",
    "name": "Subject test",
    "status": "draft",
    "winnerCriteria": "open_rate",
    "variants": [
      {
        "id": "var_a",
        "variantId": "var_a",
        "abTestId": "ab_abc123",
        "label": "A",
        "variantLabel": "A",
        "emailId": "email_abc123",
        "subject": "Welcome",
        "blocks": [
          {
            "id": "block_123",
            "type": "html",
            "content": "<h1>Hello</h1>",
            "styles": {
              "backgroundColor": "#f8fafc",
              "backgroundOpacity": 80,
              "textColor": "#111827",
              "borderRadius": 12,
              "borderColor": "#cbd5e1",
              "borderWidth": 1
            },
            "conditions": [
              {
                "id": "c1",
                "value": "plan:pro"
              }
            ]
          }
        ]
      }
    ]
  }
}

Changes