Skip to main content
POST
/
focus-groups
cURL
curl -X POST https://app.mavera.io/api/v1/focus-groups \
  -H "Authorization: Bearer mvra_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Product Feedback Study",
    "sample_size": 50,
    "persona_ids": ["persona_id_1", "persona_id_2"],
    "questions": [
      {
        "question": "How likely are you to recommend this product?",
        "type": "net_promoter_score"
      },
      {
        "question": "What features do you value most?",
        "type": "multiple_choice_multiple",
        "options": ["Price", "Quality", "Design", "Brand"]
      }
    ]
  }'
{
  "id": "cly2xyz3e0001efghij456789",
  "object": "focus_group",
  "status": "pending",
  "created_at": 1706380800,
  "name": "Product Feedback Study Q1 2026",
  "sample_size": 50,
  "credits_charged": 500,
  "personas": [
    {
      "id": "<string>",
      "name": "<string>"
    }
  ],
  "questions": [
    {
      "id": "<string>",
      "question": "<string>",
      "type": "<string>",
      "options": [
        "<string>"
      ],
      "order": 123
    }
  ]
}

Authorizations

​
Authorization
string
header
required

API key prefixed with mvra_live_. Create keys at Settings > Developer > API Keys.

Body

application/json
​
name
string
required

Name/title for the focus group study.

Required string length: 3 - 100
Example:

"Product Feedback Study Q1 2026"

​
sample_size
integer
required

Number of responses to generate per persona per question.

Required range: 1 <= x <= 500
Example:

50

​
persona_ids
string[]
required

Array of persona IDs to participate in the focus group. Get persona IDs from GET /personas.

Required array length: 1 - 20 elements
Example:
[
  "clx1abc2d0001abcdef123456",
  "clx1abc2d0002abcdef789012"
]
​
questions
object[]
required

Array of questions for the focus group.

Required array length: 1 - 50 elements

Response

Focus group created and processing started.

​
id
string

Unique focus group ID.

Example:

"cly2xyz3e0001efghij456789"

​
object
enum<string>
Available options:
focus_group
Example:

"focus_group"

​
status
enum<string>

Current processing status.

Available options:
pending,
generating,
completed,
failed
Example:

"pending"

​
created_at
integer

Unix timestamp of creation.

Example:

1706380800

​
name
string
Example:

"Product Feedback Study Q1 2026"

​
sample_size
integer
Example:

50

​
credits_charged
integer

Total credits charged for this focus group.

Example:

500

​
personas
object[]
​
questions
object[]