---
title: "Create Image Poll"
method: POST
path: "/image-polls/"
---

# Create Image Poll

`POST /image-polls/`

## Request body

- object
  - `question` string, required — The prompt or question for the prediction to be made
  - `options` object[], required — List of options for this prediction, min 2 and max 4
    - `description` string, required — Description of the option
    - `image_url` boolean, required — URL to the option image
  - `program_id` string, required — ID of the program to create the prediction for
  - `interactive_until` string, date — The UTC time that the widget will stop accepting interactions
  - `playback_time_ms` integer — Video playback time in milliseconds
  - `timeout` string, required — A iso8601 duration hint for when a Widget should be timed out
  - `custom_data` string — A free-form field used for custom behaviors
  - `widget_attributes` object[] — An array of key value pairs used for custom behaviors
    - `key` string, required
    - `value` string, required

## Response `201`

201

- 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
  - `options` object[]
    - `description` string
    - `id` string
    - `image_url` string
    - `translatable_fields` string[]
    - `translations` object
    - `vote_count` integer
    - `vote_url` 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
  - `url` string
  - `widget_interactions_url_template` string

---

[API](https://skmtc.net/livelike/apis/engagement-suite.md) · [All operations](https://skmtc.net/livelike/apis/engagement-suite/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/livelike/engagement-suite/revisions/f3171d1c30f7/schema)