Skip to main content
POST
/
api
/
public
/
v1
/
studies
/
{study_id}
/
panel
Create Panel
curl --request POST \
  --url https://api.userintuition.ai/api/public/v1/studies/{study_id}/panel \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "target": 123,
  "country_code": "US",
  "frequency": "<string>",
  "dry_run": false
}
'
{
  "study_id": "<string>",
  "panel_status": "<string>",
  "dry_run": true,
  "target": 123,
  "estimated_total_cost_per_interview_usd": 123,
  "estimated_total_cost_usd": 123,
  "estimated_timeline_hours": [
    123
  ]
}

Authorizations

​
Authorization
string
header
required

Authenticate with an API key (prefixed ui_sk_) or a JWT token from the dashboard.

Path Parameters

​
study_id
string
required

Body

application/json

Field a paid panel for a Panel-type study. The interview language is taken from the study (not set here).

​
target
integer
required

Target number of completed responses

​
country_code
string
default:US

Country code, e.g. US, GB, FR

​
frequency
string | null

weekly | monthly | quarterly. Omit for a one-time target.

​
dry_run
boolean
default:false

Return a cost estimate without provisioning the panel

Response

Successful Response

Either a launch acknowledgement (study_id + panel_status) or, for dry_run, a cost + timeline estimate.

​
study_id
string | null
​
panel_status
string | null
​
dry_run
boolean | null
​
target
integer | null
​
estimated_total_cost_per_interview_usd
number | null

Per-interview cost in USD (interview credit cost + participant reward).

​
estimated_total_cost_usd
number | null

Total estimated cost in USD (per-interview × target).

​
estimated_timeline_hours
number[] | null

Estimated time to complete, [min, max] hours.