---
title: "Create a Text Quiz"
method: POST
path: "/text-quizzes/"
---

# Create a Text Quiz

`POST /text-quizzes/`

## Request

- Base URL: `https://cf-blast.livelikecdn.com/api/v1`
- URL: `https://cf-blast.livelikecdn.com/api/v1/text-quizzes/`
- Auth: none required

## Request body

- object
  - `program_id` string, required: The id of the program to create the Text Quiz for
  - `question` string, required: The question or prompt asked by the Text Quiz
  - `choices` unknown[], required: The choices of the Text Quiz
    - unknown
  - `interactive_until` string, date: The UTC time that the widget will stop accepting interactions
  - `playback_time_ms` integer: Video playback time in milliseconds
  - `custom_data` string
  - `widget_attributes` object[]
    - `key` string, required
    - `value` string, required
  - `sponsor_ids` string[]: Links the ```sponsors``` with this Text Quiz. Note that only valid sponsor_ids will be linked to a Text Quiz.

## Response `201`

201

- object
  - `choices` object[]
    - `answer_count` integer
    - `answer_url` string
    - `description` string
    - `id` string
    - `is_correct` boolean
    - `translatable_fields` string[]
    - `translations` object
  - `client_id` string
  - `created_at` string
  - `created_by` object
    - `id` string
    - `image_url` unknown
    - `name` unknown
  - `custom_data` unknown
  - `engagement_count` integer
  - `engagement_percent` string
  - `id` string
  - `impression_count` integer
  - `impression_url` string
  - `interaction_url` string
  - `interactive_until` string
  - `kind` string
  - `program_date_time` unknown
  - `program_id` string
  - `publish_delay` string
  - `published_at` string
  - `question` string
  - `reactions` unknown[]
    - unknown
  - `rewards_url` unknown
  - `schedule_url` string
  - `scheduled_at` string
  - `sponsors` unknown[]
    - unknown
  - `status` string
  - `subscribe_channel` string
  - `timeout` string
  - `translatable_fields` string[]
  - `translations` object
  - `unique_impression_count` integer
  - `playback_time_ms` unknown
  - `url` string
  - `widget_interactions_url_template` string

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `3e5529c26ce4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/livelike/apis/engagement-suite/changes/text-quizzes/post.md)

---

[API](https://skmtc.dev/livelike/apis/engagement-suite.md) - [All operations](https://skmtc.dev/livelike/apis/engagement-suite/llms.txt) - [OpenAPI document](https://skmtc.dev/livelike/apis/engagement-suite/revisions/3e5529c26ce4?raw)
