Create a remote configuration

curl --request POST \
  --url https://api.qonversion.io/v4/remote-configurations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Onboarding copy",
  "context_key": "onboarding_copy_v1",
  "segment_percent": 100,
  "segmentation_conditions": [
    {
      "code": "platform",
      "comparator": "in",
      "type": "string",
      "values": [
        "ios",
        "android"
      ]
    }
  ]
}
'

import requests

url = "https://api.qonversion.io/v4/remote-configurations"

payload = {
    "name": "Onboarding copy",
    "context_key": "onboarding_copy_v1",
    "segment_percent": 100,
    "segmentation_conditions": [
        {
            "code": "platform",
            "comparator": "in",
            "type": "string",
            "values": ["ios", "android"]
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Onboarding copy',
    context_key: 'onboarding_copy_v1',
    segment_percent: 100,
    segmentation_conditions: [
      {code: 'platform', comparator: 'in', type: 'string', values: ['ios', 'android']}
    ]
  })
};

fetch('https://api.qonversion.io/v4/remote-configurations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.qonversion.io/v4/remote-configurations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Onboarding copy',
    'context_key' => 'onboarding_copy_v1',
    'segment_percent' => 100,
    'segmentation_conditions' => [
        [
                'code' => 'platform',
                'comparator' => 'in',
                'type' => 'string',
                'values' => [
                                'ios',
                                'android'
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

require 'uri'
require 'net/http'

url = URI("https://api.qonversion.io/v4/remote-configurations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Onboarding copy\",\n  \"context_key\": \"onboarding_copy_v1\",\n  \"segment_percent\": 100,\n  \"segmentation_conditions\": [\n    {\n      \"code\": \"platform\",\n      \"comparator\": \"in\",\n      \"type\": \"string\",\n      \"values\": [\n        \"ios\",\n        \"android\"\n      ]\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qonversion.io/v4/remote-configurations"

	payload := strings.NewReader("{\n  \"name\": \"Onboarding copy\",\n  \"context_key\": \"onboarding_copy_v1\",\n  \"segment_percent\": 100,\n  \"segmentation_conditions\": [\n    {\n      \"code\": \"platform\",\n      \"comparator\": \"in\",\n      \"type\": \"string\",\n      \"values\": [\n        \"ios\",\n        \"android\"\n      ]\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.qonversion.io/v4/remote-configurations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Onboarding copy\",\n  \"context_key\": \"onboarding_copy_v1\",\n  \"segment_percent\": 100,\n  \"segmentation_conditions\": [\n    {\n      \"code\": \"platform\",\n      \"comparator\": \"in\",\n      \"type\": \"string\",\n      \"values\": [\n        \"ios\",\n        \"android\"\n      ]\n    }\n  ]\n}")
  .asString();

{
  "object": "remote_configuration",
  "id": "82a42dc2-76f6-46c2-b883-846acaf2070a",
  "url": "/v4/remote-configurations/82a42dc2-76f6-46c2-b883-846acaf2070a",
  "name": "Onboarding copy",
  "status": "active",
  "segment_percent": 100,
  "segmentation_conditions": [
    {
      "code": "platform",
      "comparator": "in",
      "type": "string",
      "values": [
        "ios",
        "android"
      ],
      "object_values": [
        {}
      ]
    }
  ],
  "priority": 1,
  "created_at": "2025-09-15T12:30:00Z",
  "updated_at": "2025-11-03T10:26:40Z",
  "context_key": "onboarding_copy_v1",
  "started_at": "2025-11-03T10:26:40Z",
  "finished_at": "2023-11-07T05:31:56Z",
  "last_applied_at": "2023-11-07T05:31:56Z"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

POST

remote-configurations

Create a remote configuration

curl --request POST \
  --url https://api.qonversion.io/v4/remote-configurations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Onboarding copy",
  "context_key": "onboarding_copy_v1",
  "segment_percent": 100,
  "segmentation_conditions": [
    {
      "code": "platform",
      "comparator": "in",
      "type": "string",
      "values": [
        "ios",
        "android"
      ]
    }
  ]
}
'

import requests

url = "https://api.qonversion.io/v4/remote-configurations"

payload = {
    "name": "Onboarding copy",
    "context_key": "onboarding_copy_v1",
    "segment_percent": 100,
    "segmentation_conditions": [
        {
            "code": "platform",
            "comparator": "in",
            "type": "string",
            "values": ["ios", "android"]
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Onboarding copy',
    context_key: 'onboarding_copy_v1',
    segment_percent: 100,
    segmentation_conditions: [
      {code: 'platform', comparator: 'in', type: 'string', values: ['ios', 'android']}
    ]
  })
};

fetch('https://api.qonversion.io/v4/remote-configurations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.qonversion.io/v4/remote-configurations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Onboarding copy',
    'context_key' => 'onboarding_copy_v1',
    'segment_percent' => 100,
    'segmentation_conditions' => [
        [
                'code' => 'platform',
                'comparator' => 'in',
                'type' => 'string',
                'values' => [
                                'ios',
                                'android'
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

require 'uri'
require 'net/http'

url = URI("https://api.qonversion.io/v4/remote-configurations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Onboarding copy\",\n  \"context_key\": \"onboarding_copy_v1\",\n  \"segment_percent\": 100,\n  \"segmentation_conditions\": [\n    {\n      \"code\": \"platform\",\n      \"comparator\": \"in\",\n      \"type\": \"string\",\n      \"values\": [\n        \"ios\",\n        \"android\"\n      ]\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qonversion.io/v4/remote-configurations"

	payload := strings.NewReader("{\n  \"name\": \"Onboarding copy\",\n  \"context_key\": \"onboarding_copy_v1\",\n  \"segment_percent\": 100,\n  \"segmentation_conditions\": [\n    {\n      \"code\": \"platform\",\n      \"comparator\": \"in\",\n      \"type\": \"string\",\n      \"values\": [\n        \"ios\",\n        \"android\"\n      ]\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.qonversion.io/v4/remote-configurations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Onboarding copy\",\n  \"context_key\": \"onboarding_copy_v1\",\n  \"segment_percent\": 100,\n  \"segmentation_conditions\": [\n    {\n      \"code\": \"platform\",\n      \"comparator\": \"in\",\n      \"type\": \"string\",\n      \"values\": [\n        \"ios\",\n        \"android\"\n      ]\n    }\n  ]\n}")
  .asString();

{
  "object": "remote_configuration",
  "id": "82a42dc2-76f6-46c2-b883-846acaf2070a",
  "url": "/v4/remote-configurations/82a42dc2-76f6-46c2-b883-846acaf2070a",
  "name": "Onboarding copy",
  "status": "active",
  "segment_percent": 100,
  "segmentation_conditions": [
    {
      "code": "platform",
      "comparator": "in",
      "type": "string",
      "values": [
        "ios",
        "android"
      ],
      "object_values": [
        {}
      ]
    }
  ],
  "priority": 1,
  "created_at": "2025-09-15T12:30:00Z",
  "updated_at": "2025-11-03T10:26:40Z",
  "context_key": "onboarding_copy_v1",
  "started_at": "2025-11-03T10:26:40Z",
  "finished_at": "2023-11-07T05:31:56Z",
  "last_applied_at": "2023-11-07T05:31:56Z"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication using the project Secret Key (prefixed with sk_, or test_sk_ for sandbox). All v4 public endpoints require the Secret Key — see Authentication. Never expose the Secret Key in client-side code.

Headers

Idempotency-Key

string

Idempotency key for safe retries.

Body

application/json

name

string

required

Display name (max 256 characters).

Example:

"Onboarding copy"

context_key

string | null

Optional stable key the SDK uses to look up this configuration.

Example:

"onboarding_copy_v1"

segment_percent

number

Optional. Percentage (0–100) of the targeted audience that receives this configuration. Defaults to 100 when omitted.

Required range: 0 <= x <= 100

Example:

100

segmentation_conditions

object[]

Optional targeting rules that narrow the audience. Omit or pass [] to target the whole audience.

Show child attributes

Example:

[
  {
    "code": "platform",
    "comparator": "in",
    "type": "string",
    "values": ["ios", "android"]
  }
]

Response

Remote configuration created

A named server-driven configuration. The read view returned by the list, create, update, and status endpoints. Only the single-configuration GET additionally embeds the inline payload values (see V4RemoteConfigurationDetail); these endpoints do not.

object

string

required

Example:

"remote_configuration"

string

required

Remote configuration identifier (UUID).

Example:

"82a42dc2-76f6-46c2-b883-846acaf2070a"

url

string

required

Canonical API path.

Example:

"/v4/remote-configurations/82a42dc2-76f6-46c2-b883-846acaf2070a"

name

string

required

Display name.

Example:

"Onboarding copy"

status

string

required

Lifecycle status. Only active configurations are served to the SDK. archived is terminal. Change via PATCH /remote-configurations/{config_id}/status.

Example:

"active"

segment_percent

number

required

Percentage (0–100) of the targeted audience that receives this configuration. 100 targets the whole audience.

Required range: 0 <= x <= 100

Example:

100

segmentation_conditions

object[]

required

Targeting rules that narrow the audience. Always present on read; [] when no conditions are set.

Show child attributes

priority

integer | null

required

Resolution priority when a user matches multiple configurations (read-only). null until the configuration is first activated.

Example:

1

created_at

string<date-time>

required

ISO 8601 creation timestamp.

Example:

"2025-09-15T12:30:00Z"

updated_at

string<date-time>

required

ISO 8601 last update timestamp.

Example:

"2025-11-03T10:26:40Z"

context_key

string | null

Optional stable key the SDK uses to look up this configuration.

Example:

"onboarding_copy_v1"

started_at

string<date-time> | null

When the configuration was activated. null while in draft.

Example:

"2025-11-03T10:26:40Z"

finished_at

string<date-time> | null

When the configuration was archived. null while not archived.

last_applied_at

string<date-time> | null

When the configuration was last served to a user.

List remote configurations

Get a remote configuration

REST API v3

REST API v4

Analytics API

Create a remote configuration

Authorizations

Headers

Body

Response