Remote Config - Condition Create

Endpoint

/i/remote-config/add-condition

Overview

Creates a condition document used for targeting parameter values.

Authentication

Countly API supports three authentication methods:

1. api_key=YOUR_API_KEY
2. auth_token=YOUR_AUTH_TOKEN
3. countly-token: YOUR_AUTH_TOKEN

Permissions

Requires remote_config Update permission.

Request Parameters

Parameter	Type	Required	Description
api_key	String	Yes (or use auth_token)	API key for authentication.
auth_token	String	No	Auth token as query parameter or countly-token header.
app_id	String	Yes	App id.
condition	String (JSON Object)	Yes	Condition payload.

Condition Structure (condition)

Field	Type	Required	Description
condition_name	String	Yes	Must match ^[a-zA-Z0-9 ]+$.
condition_color	Number	Yes	Color index used by dashboard.
condition	Object/String	Yes	Condition query definition.
seed_value	String	No	Seed used in rollout percentile logic.

Response

Success Response

"65f1f7b2ad5b9b001f12ab34"

Response Fields

Field	Type	Description
(root)	String	Newly created condition id.

Error Responses

• 400

{
  "result": "Invalid parameter: condition_name"
}

• 400

{
  "result": "Invalid parameter: condition_color"
}

• 400

{
  "result": "Invalid parameter: condition"
}

• 500

{
  "result": "The condition already exists"
}

Behavior/Processing

• Parses condition JSON string.
• Serializes nested condition.condition object to JSON string before storing.
• Emits system log action: rc_condition_created.

Database Collections

Collection	Used for	Data touched by this endpoint
countly_out.remoteconfig_conditions{appId}	Condition storage	Validates duplicates and inserts condition document.
countly.systemlogs	Audit trail	Receives rc_condition_created action.

---

Examples

Create condition

/i/remote-config/add-condition?api_key=YOUR_API_KEY&app_id=6991c75b024cb89cdc04efd2&condition={"condition_name":"iOS Users","condition_color":1,"condition":{"up._os":{"$eq":"iOS"}},"seed_value":"button_color"}

Related Endpoints

• Remote Config - Condition Update
• Remote Config - Condition Delete

Last Updated

2026-03-05