Create URL A/B Test

Create a new A/B test for a short URL to compare different destination pages and optimize for conversions.

Body Parameters

name

string

required

The name of the A/B test.

primary_url_id

string

The UUID of an existing primary short URL to run the A/B test on. If omitted, a new rotator short link will be programmatically created and launched.

short_code

string

Optional custom short code alias for the new rotator link (only used if primary_url_id is omitted).

url_type

string

default:"standard"

Optional. The domain context to use for the new rotator link. One of standard, branded, or subdomain.

subdomain

string

Optional. The verified subdomain name to use for the new rotator link (required if url_type is subdomain).

branded_domain

string

Optional. The verified branded custom domain to use for the new rotator link (required if url_type is branded).

variants

object[]

required

Array of variant configurations. At least 2 variants are required.

variants[].name

string

Name of the variant (e.g., “Control”, “Page B”).

variants[].destination_url

string

required

The destination URL for this variant.

variants[].traffic_weight

number

Percentage of traffic to route to this variant. Defaults to an equal split among all variants if not specified. Must sum to 100 if traffic_split_mode is weighted.

description

string

Optional description for the test.

hypothesis

string

Optional hypothesis explaining the expected outcome of the test.

traffic_split_mode

string

default:"equal"

How traffic is split. One of equal or weighted.

conversions_enabled

boolean

default:false

Optional. Enable conversion tracking (leads, sales, signups) for this test.

min_sample_size

number

default:"100"

Minimum number of clicks required before statistical significance is calculated.

confidence_level

number

default:"95"

Target confidence level percentage (e.g., 90, 95, 99).

Request Examples

curl -X POST "https://jmpy.me/api/v1/url-ab-tests" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Landing Page CTA Test",
    "primary_url_id": "url_abc123",
    "variants": [
      { "name": "Control", "destination_url": "https://mysite.com/landing-a", "traffic_weight": 50 },
      { "name": "Variant B", "destination_url": "https://mysite.com/landing-b", "traffic_weight": 50 }
    ]
  }'

const response = await fetch('https://jmpy.me/api/v1/url-ab-tests', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Landing Page CTA Test',
    primary_url_id: 'url_abc123',
    variants: [
      { name: 'Control', destination_url: 'https://mysite.com/landing-a', traffic_weight: 50 },
      { name: 'Variant B', destination_url: 'https://mysite.com/landing-b', traffic_weight: 50 }
    ]
  })
});

import axios from 'axios';

const response = await axios.post('https://jmpy.me/api/v1/url-ab-tests', {
  name: 'Landing Page CTA Test',
  primary_url_id: 'url_abc123',
  variants: [
    { name: 'Control', destination_url: 'https://mysite.com/landing-a', traffic_weight: 50 },
    { name: 'Variant B', destination_url: 'https://mysite.com/landing-b', traffic_weight: 50 }
  ]
}, {
  headers: { 'Authorization': 'Bearer <token>' }
});

import requests

response = requests.post(
    "https://jmpy.me/api/v1/url-ab-tests",
    headers={"Authorization": "Bearer <token>"},
    json={
        "name": "Landing Page CTA Test",
        "primary_url_id": "url_abc123",
        "variants": [
            {"name": "Control", "destination_url": "https://mysite.com/landing-a", "traffic_weight": 50},
            {"name": "Variant B", "destination_url": "https://mysite.com/landing-b", "traffic_weight": 50}
        ]
    }
)

package main

import (
    "bytes"
    "net/http"
    "encoding/json"
)

func main() {
    data := map[string]interface{}{
        "name": "Landing Page CTA Test",
        "primary_url_id": "url_abc123",
        "variants": []map[string]interface{}{
            {"name": "Control", "destination_url": "https://mysite.com/landing-a", "traffic_weight": 50},
            {"name": "Variant B", "destination_url": "https://mysite.com/landing-b", "traffic_weight": 50},
        },
    }
    jsonData, _ := json.Marshal(data)
    
    req, _ := http.NewRequest("POST", "https://jmpy.me/api/v1/url-ab-tests", bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "Bearer <token>")
    req.Header.Set("Content-Type", "application/json")
    http.DefaultClient.Do(req)
}

<?php
$client = new GuzzleHttp\Client();
$response = $client->request('POST', 'https://jmpy.me/api/v1/url-ab-tests', [
    'headers' => [
        'Authorization' => 'Bearer <token>',
        'Content-Type' => 'application/json'
    ],
    'json' => [
        'name' => 'Landing Page CTA Test',
        'primary_url_id' => 'url_abc123',
        'variants' => [
            ['name' => 'Control', 'destination_url' => 'https://mysite.com/landing-a', 'traffic_weight' => 50],
            ['name' => 'Variant B', 'destination_url' => 'https://mysite.com/landing-b', 'traffic_weight' => 50]
        ]
    ]
]);
?>

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.URI;
import java.net.http.HttpResponse;

String json = """
{
    "name": "Landing Page CTA Test",
    "primary_url_id": "url_abc123",
    "variants": [
        { "name": "Control", "destination_url": "https://mysite.com/landing-a", "traffic_weight": 50 },
        { "name": "Variant B", "destination_url": "https://mysite.com/landing-b", "traffic_weight": 50 }
    ]
}
""";

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://jmpy.me/api/v1/url-ab-tests"))
    .header("Authorization", "Bearer <token>")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(json))
    .build();
client.send(request, HttpResponse.BodyHandlers.ofString());

Use Cases

Simple 50/50 Split

Create a standard A/B test split equally between two destinations.

const response = await fetch('https://jmpy.me/api/v1/url-ab-tests', {
  method: 'POST',
  headers: { 
    'Authorization': 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: "Headline Test",
    primary_url_id: "url_123",
    variants: [
      { name: "Original", destination_url: "https://site.com/a" },
      { name: "New Headline", destination_url: "https://site.com/b" }
    ]
  })
});

Weighted 90/10 Rollout

Slowly roll out a new page to only 10% of users.

const response = await fetch('https://jmpy.me/api/v1/url-ab-tests', {
  method: 'POST',
  headers: { 
    'Authorization': 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: "New Feature Rollout",
    primary_url_id: "url_123",
    traffic_split_mode: "weighted",
    variants: [
      { name: "Stable", destination_url: "https://site.com/v1", traffic_weight: 90 },
      { name: "Beta", destination_url: "https://site.com/v2", traffic_weight: 10 }
    ]
  })
});

List A/B Tests

View your existing tests

Start Test

Launch a created test

Short URL Details

Get primary URL ID

Analytics

Monitor test performance

Response Examples

201 Created
400 Invalid Input
403 Feature Disabled

{
  "test": {
    "id": "test_url_789",
    "user_id": "usr_55555",
    "name": "Landing Page CTA Test",
    "primary_url_id": "url_abc123",
    "status": "draft",
    "variants": [
      {
        "id": "var_a",
        "test_id": "test_url_789",
        "name": "Control",
        "destination_url": "https://mysite.com/landing-a",
        "traffic_weight": 50
      },
      {
        "id": "var_b",
        "test_id": "test_url_789",
        "name": "Variant B",
        "destination_url": "https://mysite.com/landing-b",
        "traffic_weight": 50
      }
    ]
  },
  "message": "A/B test created successfully"
}

{
  "success": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "At least 2 variants are required"
  }
}

{
  "success": false,
  "error": {
    "code": "FEATURE_DISABLED",
    "message": "A/B Testing is not available on your plan"
  }
}

API Reference

Short URLs

Bulk URLs

Custom Aliases

QR Codes

Domains

Campaigns

Conversion Tracking

Short URL Analytics

QR Code Analytics

Short URL A/B Testing

QR Code A/B Testing

Body Parameters

Request Examples

Use Cases

List A/B Tests

Start Test

Short URL Details

Analytics

Response Examples

API Reference

Short URLs

Bulk URLs

Custom Aliases

QR Codes

Domains

Campaigns

Conversion Tracking

Short URL Analytics

QR Code Analytics

Short URL A/B Testing

QR Code A/B Testing

​Body Parameters

​Request Examples

​Use Cases

List A/B Tests

Start Test

Short URL Details

Analytics

​Response Examples

Body Parameters

Request Examples

Use Cases

Response Examples