Start a form A/B setup

Start a form A/B test by ID. Launches the A/B setup so its variants begin serving to visitors according to
their weights, moving the setup to enabled status.
Starting a form A/B setup that has already been started returns a conflict.

An optional auto-close policy can be supplied in the request body. endsAt closes the test at a fixed
instant and must be in the future. stopOnSignificance closes the test as soon as one variant is a
statistically significant winner; on its own it is subject to a seven-day minimum runtime. Supply at least
one of the two, or omit autoClose entirely for a test that never closes automatically. The policy cannot
be changed after the test has started.

Scopes:
forms.write

Rate Limiting:
This endpoint is rate limited to 400 requests per minute.

Path Params
string
required

Form A/B setup ID

Body Params

Optional auto-close policy

Request to start a form A/B setup.

autoClose
object

Optional auto-close policy applied when the test starts. Omit for a test that never closes automatically.

Headers
string
required
Defaults to 2026-preview

API version that specifies the response format and behaviour

Responses
204

Form A/B test started

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json