---
title: "Create an Image Number Prediction"
method: POST
path: "/image-number-predictions/"
---

# Create an Image Number Prediction

`POST /image-number-predictions/`

## Request

- Base URL: `https://cf-blast.livelikecdn.com/api/v1`
- URL: `https://cf-blast.livelikecdn.com/api/v1/image-number-predictions/`
- Auth: none required

## Request body

- object
  - `program_id` string, required: The id of the program to create the Image Number Prediction for
  - `question` string, required: The question or prompt asked by the Image Number Prediction
  - `options` unknown[]: The options of the Image Number Prediction
    - unknown
  - `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 Prediction. Note that only valid sponsor_ids will be linked to a Prediction.

## Response `201`

201

- object
  - `id` string
  - `url` string
  - `kind` string
  - `program_id` string
  - `client_id` string
  - `created_at` string
  - `interactive_until` string
  - `published_at` string
  - `scheduled_at` string
  - `follow_up_url` string
  - `follow_ups` object[]
    - `id` string
    - `url` string
    - `program_id` string
    - `client_id` string
    - `image_number_prediction_id` string
    - `image_number_prediction_url` string
    - `timeout` string
    - `published_at` string
    - `scheduled_at` string
    - `created_at` string
    - `subscribe_channel` string
    - `kind` string
    - `options` object[]
      - `id` string
      - `url` string
      - `description` string
      - `correct_number` unknown
      - `image_url` string
      - `translations` object
      - `translatable_fields` string[]
    - `question` string
    - `program_date_time` unknown
    - `publish_delay` string
    - `interaction_url` string
    - `impression_url` string
    - `interactive_until` unknown
    - `impression_count` integer
    - `unique_impression_count` integer
    - `engagement_count` unknown
    - `engagement_percent` unknown
    - `status` string
    - `created_by` object
      - `id` string
      - `name` unknown
      - `image_url` unknown
    - `schedule_url` string
    - `rewards_url` unknown
    - `translations` object
    - `translatable_fields` unknown[]
      - unknown
    - `reactions` unknown[]
      - unknown
    - `custom_data` unknown
    - `claim_url` string
    - `sponsors` unknown[]
      - unknown
    - `widget_interactions_url_template` string
  - `question` string
  - `confirmation_message` string
  - `timeout` string
  - `options` object[]
    - `id` string
    - `url` string
    - `description` string
    - `correct_number` unknown
    - `image_url` string
    - `translations` object
    - `translatable_fields` string[]
  - `subscribe_channel` string
  - `program_date_time` unknown
  - `publish_delay` string
  - `interaction_url` string
  - `impression_url` string
  - `impression_count` integer
  - `unique_impression_count` integer
  - `engagement_count` integer
  - `engagement_percent` string
  - `status` string
  - `created_by` object
    - `id` string
    - `name` unknown
    - `image_url` unknown
  - `schedule_url` string
  - `rewards_url` unknown
  - `translations` object
  - `translatable_fields` string[]
  - `reactions` unknown[]
    - unknown
  - `custom_data` unknown
  - `sponsors` unknown[]
    - unknown
  - `playback_time_ms` unknown
  - `widget_interactions_url_template` string
  - `vote_url` string

## Other responses

- `400`: 400

## Changes

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

[Operation history](https://skmtc.dev/livelike/apis/engagement-suite/changes/image-number-predictions/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)