# Add video interaction (`add_interaction`)
> Adds an interactive element at a chosen timestamp: a poll, quiz, question, rating, free-text prompt, or a call-to-action or lead form.
- Area: [Interactions & leads](https://mcp.dadan.io/tools/interactions-leads.md)
- Access: Makes changes; has an irreversible path, so clients ask to confirm (a CTA is a one-per-video upsert, so adding one replaces the live CTA (polls and quizzes stack instead))
- AI credits: no
- Available on read-only connections: no

## Example prompt
"Add a quick poll at the two-minute mark asking which feature they'd use most"

## Parameters
- `video_id` (string, required): The video's guid.
- `kind` ("poll" | "quiz" | "question" | "rating" | "free_text" | "cta" | "lead_form", required): The interaction kind: poll, quiz, question, rating, free_text, cta, or lead_form.
- `time_seconds` (number, required): When to show it, in seconds from the video start.
- `prompt` (string): The question/prompt text (poll, quiz, question, rating, free_text, lead_form).
- `options` (string[]): Answer options for a poll or quiz (2 or more).
- `correct_option` (integer): For a quiz: the 0-based index into options of the correct answer.
- `cta_label` (string): For a cta: the button label. Defaults to 'Learn more'.
- `cta_url` (string): For a cta: the destination URL the button opens.
- `required` (boolean): Whether the viewer must respond before continuing. Default false.

## Description for AI assistants
Add an interactive element to a video at a given timestamp. Supported kinds: 'poll' and 'quiz' (need 2+ options; quiz also takes correct_option), 'question', 'rating', 'free_text' (use prompt), 'cta' (call-to-action button — needs cta_url, optional cta_label), and 'lead_form' (capture viewer contact details). NOTE: polls/quizzes/questions/ratings/free-text are added (a video can have many); 'cta' and 'lead_form' are single-per-video and REPLACE any existing one. Plan-gated: returns upgrade_required if the account's plan doesn't include interactions/CTAs. Use the video guid from search_videos/get_video.


## Known limitations

- A CTA and a lead form are single-per-video upserts: adding one REPLACES the one already live. Polls and quizzes stack instead.
- Only lead forms capture identities. Poll and quiz results are aggregate counts.


## Used in these prompts

- Send a branded video pitch with a CTA (Sales): "Take my product walkthrough [link], add a title card that says "[Prospect], here's your 3-minute tour", set a "Book a call" button near the end (it replaces any existing button), and give me a one-click share link to send."
- Capture leads from a public demo (Sales): "On my public demo video [link], add a short lead-capture form at the start asking for name and work email, then list everyone who's submitted it so far."
- Gather feedback right inside a video (Success & Support): "Add a quick "Was this helpful?" rating and a one-question poll at the end of [link], then show me the response counts so far."
- Turn a lesson into an interactive course (Trainers & Educators): "Add chapters to my training video [link], drop a quiz question after each section, and give me a link students can watch without logging in."
Canonical page: https://mcp.dadan.io/tools/add-interaction
