---
title: "Create a Text Ask widget"
method: POST
path: "/"
---

# Create a Text Ask widget

`POST /`

## Request

- Base URL: `https://cf-blast.livelikecdn.com/api/v1/text-asks`
- URL: `https://cf-blast.livelikecdn.com/api/v1/text-asks/`
- Auth: OAuth 2

Ask your audience. Collect their replies, and feature the best ones.

## Request body

- object
  - `program_id` string, required: The Program ID
  - `title` string, required: The title of the Ask widget
  - `prompt` string, required: The question or "prompt" to ask the user.
  - `confirmation_message` string: The message displayed to the user when they make their submission
  - `interactive_until` string, date: The UTC time that the widget will stop accepting interactions
  - `playback_time_ms` integer: Video playback time in milliseconds
  - `sponsor_ids` string[]: Links the ```sponsors``` with this Text Ask. Note that only valid sponsor_ids will be linked to a Text Ask.

## Response `201`

201

- object
  - `client_id` string
  - `confirmation_message` 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
  - `prompt` string
  - `publish_delay` string
  - `published_at` string
  - `reactions` unknown[]
    - unknown
  - `reply_count` integer
  - `reply_url` string
  - `rewards_url` unknown
  - `schedule_url` string
  - `scheduled_at` string
  - `status` string
  - `subscribe_channel` string
  - `timeout` string
  - `title` string
  - `translatable_fields` string[]
  - `translations` object
  - `unique_impression_count` integer
  - `url` string
  - `widget_interactions_url_template` string
  - `playback_time_ms` unknown

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/livelike/apis/text-ask.md) - [All operations](https://skmtc.dev/livelike/apis/text-ask/llms.txt) - [OpenAPI document](https://skmtc.dev/livelike/apis/text-ask/revisions/a98cea3c4825?raw)