Influencer, Giveaway 1.0.0
| Template | Influencer, tpl_3245d6e9ee79 |
|---|---|
| Variant | Giveaway |
| Version | 1.0.0, the newest: what a channel following this variant draws |
| Shapes | 9x16, 4x5, 1x1, 16x9, 2x3 |
| Length | 13 seconds |
Example video
The 1x1 cut of this version, drawn from its own worked example. Open the video on its own.
What it accepts
A creator's giveaway: what can be won, with one to four pictures and its value, the two to five rules to enter, the deadline, the partner and a call to action. The clip is as long as the rules need. metaData is the post's title, descriptions and hashtags and is never drawn.
| Field | Type | Required | Limit | What it is |
|---|---|---|---|---|
clipData | group | yes | Clip data: Everything drawn in the clip: the prize, the rules, the deadline, the partner and the call to action. The creator is the brand's badge. | |
clipData.kicker | text | up to 24 characters | Kicker: A short sticker above the headline, such as Giveaway. | |
clipData.headline | text | yes | up to 56 characters | Headline: What can be won. |
clipData.subline | text | up to 90 characters | What is in it: The prize in one line. | |
clipData.pictures | list | at least 1, up to 4 | Prize pictures: One to four pictures of the prize, any shape. Without them, a gift stands in. | |
clipData.pictures[] | image | media:// file from the media library, alt text up to 120 characters | Picture: A picture of the prize, cut out or a photo, any shape. | |
clipData.prizeValue | number | from 0, 2 decimals | Value: What the prize is worth, in the currency below. Shown exactly as sent. | |
clipData.prizeValueLabel | text | up to 16 characters | Value label: The word beside the value, such as Worth. | |
clipData.currency | text | up to 3 characters | Currency: The ISO code the value is in, such as EUR, GBP or USD. | |
clipData.steps | list | yes | at least 2, up to 5 | How to enter: Two to five rules, shown one after another; the clip gets a second and a half longer for each. |
clipData.steps[] | group | Rule | ||
clipData.steps[].text | text | yes | up to 56 characters | Rule: What to do. |
clipData.steps[].icon | enum | check, circle-check, x, arrow-right, arrow-up-right, plus, star, heart, thumbs-up, sparkles, zap, clock, calendar, map-pin, info, triangle-alert, lightbulb, target, award, crown, gem, flame, timer, list-checks, clipboard-check, badge-check, hand-heart, rocket, trophy, megaphone, bell, qr-code, ticket, gift, key-round, book-open, graduation-cap, house, phone, mail, globe, users, user, camera, video, play, music, mic, message-circle, share-2, bookmark, dumbbell, footprints, palette, brush, glasses, watch, mountain, plane, heart-pulse, flower-2, moon, eye | Icon: A line icon for the rule. Without one, the rule's number stands in. | |
clipData.deadline | text | up to 48 characters | Deadline: When the giveaway closes, as it should be read. | |
clipData.partner | group | Partner: The brand the giveaway is with, shown beside the creator. | ||
clipData.partner.label | text | up to 24 characters | Line: The words before the partner's name, such as In partnership with. | |
clipData.partner.name | text | up to 32 characters | Name: The partner's name. | |
clipData.partner.logo | image | media:// file from the media library, alt text up to 120 characters | Logo: The partner's logo, any shape. | |
clipData.cta | group | Call to action: The button at the end and the line under it, such as a web address, a handle or a phone number. | ||
clipData.cta.label | text | yes | up to 28 characters | Button: What the button says. |
clipData.cta.detail | text | up to 48 characters | Line under it: An address, a handle, a phone number. | |
clipData.disclaimer | text | up to 160 characters | Small print: The terms that must be shown with a giveaway. | |
clipData.look | group | Look: How the clip looks and moves. The same five switches in every format (theme, pace, corners, alignment, logo), plus this format's own. Leave any out for the format's default. | ||
clipData.look.theme | enum | brand, light, dark, bold | Theme: Brand: your brand's own colours and background. Light or dark: a page tinted with your brand colour. Bold: your brand colour as the page. | |
clipData.look.pace | enum | calm, standard, punchy | Pace: How things arrive: calm fades, a standard rhythm, or punchy slams and hard cuts. | |
clipData.look.corners | enum | square, soft, round | Corners: The shape of cards, pictures and buttons. | |
clipData.look.align | enum | start, centre | Text alignment: Where the text lines up. | |
clipData.look.pictureFit | enum | contain, cover | Prize pictures: Cut out: the whole product on a card. Photo: the picture fills its frame. | |
clipData.look.celebrate | boolean | Unwrap and confetti: The prize is unwrapped like a present and confetti flies, at the start and at the end. | ||
clipData.look.logo | enum | auto, free | Logo: The style's own: the logo on the style's plate (a card, a disc, a badge) so it reads on any page. As it is: the logo whole, with no plate, frame or crop, for a logo made to stand on the page, such as one with a transparent background. As it is, make sure your logo reads on the page of the theme you choose. | |
metaData | group | Meta data: Everything about the post that is never drawn in the clip: its title, its description in four lengths, one per kind of platform, and its hashtags. Reelwire adds the brand's description, link and hashtags after it. Left out, the post text is generated from the clip data. | ||
metaData.title | text | up to 100 characters | Title: Used where the platform has a title of its own: Facebook Feed, LinkedIn, Pinterest and YouTube. Up to 100 characters, which every one of them takes. | |
metaData.captionTiny | text | up to 200 characters | Tiny description (Pinterest, Threads, X): Up to 200 characters. The brand's description, link and hashtags follow it within the platform's limit. | |
metaData.captionShort | text | up to 500 characters | Short description (Telegram, Threema, WeChat, WhatsApp): Up to 500 characters. The brand's description, link and hashtags follow it within the platform's limit. | |
metaData.captionMedium | text | up to 1500 characters | Medium description (Discord, Facebook Reels, Instagram, LinkedIn, Signal, Slack, TikTok): Up to 1500 characters. The brand's description, link and hashtags follow it within the platform's limit. | |
metaData.captionLong | text | up to 4000 characters | Long description (Facebook Feed, YouTube): Up to 4000 characters. The brand's description, link and hashtags follow it within the platform's limit. | |
metaData.hashtags | list | up to 15 | Hashtags: Written without the #. Up to 15, which every platform takes. | |
metaData.hashtags[] | text | up to 60 characters | Hashtag |
locales carries other languages: under each language code, the parts of clipData and metaData that differ, laid over the default, so a language with no copy still renders.
A picture is always a file from your media library: media:// followed by its id or its name.
Anything the table does not list is refused, and so is anything over its limit, with a 422 that
names the field.
The JSON Schema
{
"type": "object",
"properties": {
"clipData": {
"type": "object",
"properties": {
"kicker": {
"type": "string",
"maxLength": 24,
"title": "Kicker",
"description": "A short sticker above the headline, such as Giveaway."
},
"headline": {
"type": "string",
"maxLength": 56,
"title": "Headline",
"description": "What can be won."
},
"subline": {
"type": "string",
"maxLength": 90,
"title": "What is in it",
"description": "The prize in one line."
},
"pictures": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"pattern": "^media:\\/\\/[^\\s/\\\\\\u0000-\\u001f][^/\\\\\\u0000-\\u001f]{0,254}$",
"title": "Picture",
"description": "A file from the workspace's media library, written media:// and the file's id or name. A web address is refused."
},
"alt": {
"type": "string",
"maxLength": 120,
"title": "Alt text",
"description": "What the picture shows, for anyone who cannot see it."
}
},
"required": [
"url"
],
"additionalProperties": false,
"title": "Picture",
"description": "A picture of the prize, cut out or a photo, any shape."
},
"minItems": 1,
"maxItems": 4,
"title": "Prize pictures",
"description": "One to four pictures of the prize, any shape. Without them, a gift stands in."
},
"prizeValue": {
"type": "number",
"minimum": 0,
"title": "Value",
"description": "What the prize is worth, in the currency below. Shown exactly as sent."
},
"prizeValueLabel": {
"type": "string",
"maxLength": 16,
"title": "Value label",
"description": "The word beside the value, such as Worth."
},
"currency": {
"type": "string",
"maxLength": 3,
"title": "Currency",
"description": "The ISO code the value is in, such as EUR, GBP or USD."
},
"steps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string",
"maxLength": 56,
"title": "Rule",
"description": "What to do."
},
"icon": {
"type": "string",
"enum": [
"check",
"circle-check",
"x",
"arrow-right",
"arrow-up-right",
"plus",
"star",
"heart",
"thumbs-up",
"sparkles",
"zap",
"clock",
"calendar",
"map-pin",
"info",
"triangle-alert",
"lightbulb",
"target",
"award",
"crown",
"gem",
"flame",
"timer",
"list-checks",
"clipboard-check",
"badge-check",
"hand-heart",
"rocket",
"trophy",
"megaphone",
"bell",
"qr-code",
"ticket",
"gift",
"key-round",
"book-open",
"graduation-cap",
"house",
"phone",
"mail",
"globe",
"users",
"user",
"camera",
"video",
"play",
"music",
"mic",
"message-circle",
"share-2",
"bookmark",
"dumbbell",
"footprints",
"palette",
"brush",
"glasses",
"watch",
"mountain",
"plane",
"heart-pulse",
"flower-2",
"moon",
"eye"
],
"title": "Icon",
"description": "A line icon for the rule. Without one, the rule's number stands in.",
"enumNames": [
"Check",
"Circle check",
"X",
"Arrow right",
"Arrow up right",
"Plus",
"Star",
"Heart",
"Thumbs up",
"Sparkles",
"Zap",
"Clock",
"Calendar",
"Map pin",
"Info",
"Triangle alert",
"Lightbulb",
"Target",
"Award",
"Crown",
"Gem",
"Flame",
"Timer",
"List checks",
"Clipboard check",
"Badge check",
"Hand heart",
"Rocket",
"Trophy",
"Megaphone",
"Bell",
"Qr code",
"Ticket",
"Gift",
"Key round",
"Book open",
"Graduation cap",
"House",
"Phone",
"Mail",
"Globe",
"Users",
"User",
"Camera",
"Video",
"Play",
"Music",
"Mic",
"Message circle",
"Share 2",
"Bookmark",
"Dumbbell",
"Footprints",
"Palette",
"Brush",
"Glasses",
"Watch",
"Mountain",
"Plane",
"Heart pulse",
"Flower 2",
"Moon",
"Eye"
]
}
},
"required": [
"text"
],
"additionalProperties": false,
"title": "Rule"
},
"minItems": 2,
"maxItems": 5,
"title": "How to enter",
"description": "Two to five rules, shown one after another; the clip gets a second and a half longer for each."
},
"deadline": {
"type": "string",
"maxLength": 48,
"title": "Deadline",
"description": "When the giveaway closes, as it should be read."
},
"partner": {
"type": "object",
"properties": {
"label": {
"type": "string",
"maxLength": 24,
"title": "Line",
"description": "The words before the partner's name, such as In partnership with."
},
"name": {
"type": "string",
"maxLength": 32,
"title": "Name",
"description": "The partner's name."
},
"logo": {
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"pattern": "^media:\\/\\/[^\\s/\\\\\\u0000-\\u001f][^/\\\\\\u0000-\\u001f]{0,254}$",
"title": "Picture",
"description": "A file from the workspace's media library, written media:// and the file's id or name. A web address is refused."
},
"alt": {
"type": "string",
"maxLength": 120,
"title": "Alt text",
"description": "What the picture shows, for anyone who cannot see it."
}
},
"required": [
"url"
],
"additionalProperties": false,
"title": "Logo",
"description": "The partner's logo, any shape."
}
},
"additionalProperties": false,
"title": "Partner",
"description": "The brand the giveaway is with, shown beside the creator."
},
"cta": {
"type": "object",
"properties": {
"label": {
"type": "string",
"maxLength": 28,
"title": "Button",
"description": "What the button says."
},
"detail": {
"type": "string",
"maxLength": 48,
"title": "Line under it",
"description": "An address, a handle, a phone number."
}
},
"required": [
"label"
],
"additionalProperties": false,
"title": "Call to action",
"description": "The button at the end and the line under it, such as a web address, a handle or a phone number."
},
"disclaimer": {
"type": "string",
"maxLength": 160,
"title": "Small print",
"description": "The terms that must be shown with a giveaway."
},
"look": {
"type": "object",
"properties": {
"theme": {
"type": "string",
"enum": [
"brand",
"light",
"dark",
"bold"
],
"title": "Theme",
"description": "Brand: your brand's own colours and background. Light or dark: a page tinted with your brand colour. Bold: your brand colour as the page.",
"enumNames": [
"Brand colours",
"Light",
"Dark",
"Bold brand colour"
]
},
"pace": {
"type": "string",
"enum": [
"calm",
"standard",
"punchy"
],
"title": "Pace",
"description": "How things arrive: calm fades, a standard rhythm, or punchy slams and hard cuts.",
"enumNames": [
"Calm",
"Standard",
"Punchy"
]
},
"corners": {
"type": "string",
"enum": [
"square",
"soft",
"round"
],
"title": "Corners",
"description": "The shape of cards, pictures and buttons.",
"enumNames": [
"Square",
"Softly rounded",
"Round"
]
},
"align": {
"type": "string",
"enum": [
"start",
"centre"
],
"title": "Text alignment",
"description": "Where the text lines up.",
"enumNames": [
"At the start of the line",
"Centred"
]
},
"pictureFit": {
"type": "string",
"enum": [
"contain",
"cover"
],
"title": "Prize pictures",
"description": "Cut out: the whole product on a card. Photo: the picture fills its frame.",
"enumNames": [
"Cut out, shown whole",
"Photo, filling the frame"
]
},
"celebrate": {
"type": "boolean",
"title": "Unwrap and confetti",
"description": "The prize is unwrapped like a present and confetti flies, at the start and at the end."
},
"logo": {
"type": "string",
"enum": [
"auto",
"free"
],
"title": "Logo",
"description": "The style's own: the logo on the style's plate (a card, a disc, a badge) so it reads on any page. As it is: the logo whole, with no plate, frame or crop, for a logo made to stand on the page, such as one with a transparent background. As it is, make sure your logo reads on the page of the theme you choose.",
"enumNames": [
"The style's own",
"As it is, no plate or crop"
]
}
},
"additionalProperties": false,
"title": "Look",
"description": "How the clip looks and moves. The same five switches in every format (theme, pace, corners, alignment, logo), plus this format's own. Leave any out for the format's default."
}
},
"required": [
"headline",
"steps"
],
"additionalProperties": false,
"title": "Clip data",
"description": "Everything drawn in the clip: the prize, the rules, the deadline, the partner and the call to action. The creator is the brand's badge."
},
"metaData": {
"type": "object",
"properties": {
"title": {
"type": "string",
"maxLength": 100,
"title": "Title",
"description": "Used where the platform has a title of its own: Facebook Feed, LinkedIn, Pinterest and YouTube. Up to 100 characters, which every one of them takes."
},
"captionTiny": {
"type": "string",
"maxLength": 200,
"title": "Tiny description (Pinterest, Threads, X)",
"description": "Up to 200 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"captionShort": {
"type": "string",
"maxLength": 500,
"title": "Short description (Telegram, Threema, WeChat, WhatsApp)",
"description": "Up to 500 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"captionMedium": {
"type": "string",
"maxLength": 1500,
"title": "Medium description (Discord, Facebook Reels, Instagram, LinkedIn, Signal, Slack, TikTok)",
"description": "Up to 1500 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"captionLong": {
"type": "string",
"maxLength": 4000,
"title": "Long description (Facebook Feed, YouTube)",
"description": "Up to 4000 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"hashtags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"title": "Hashtag"
},
"maxItems": 15,
"title": "Hashtags",
"description": "Written without the #. Up to 15, which every platform takes."
}
},
"additionalProperties": false,
"title": "Meta data",
"description": "Everything about the post that is never drawn in the clip: its title, its description in four lengths, one per kind of platform, and its hashtags. Reelwire adds the brand's description, link and hashtags after it. Left out, the post text is generated from the clip data."
},
"locales": {
"type": "object",
"additionalProperties": {
"type": "object",
"properties": {
"clipData": {
"type": "object",
"properties": {
"kicker": {
"type": "string",
"maxLength": 24,
"title": "Kicker",
"description": "A short sticker above the headline, such as Giveaway."
},
"headline": {
"type": "string",
"maxLength": 56,
"title": "Headline",
"description": "What can be won."
},
"subline": {
"type": "string",
"maxLength": 90,
"title": "What is in it",
"description": "The prize in one line."
},
"pictures": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"pattern": "^media:\\/\\/[^\\s/\\\\\\u0000-\\u001f][^/\\\\\\u0000-\\u001f]{0,254}$",
"title": "Picture",
"description": "A file from the workspace's media library, written media:// and the file's id or name. A web address is refused."
},
"alt": {
"type": "string",
"maxLength": 120,
"title": "Alt text",
"description": "What the picture shows, for anyone who cannot see it."
}
},
"required": [
"url"
],
"additionalProperties": false,
"title": "Picture",
"description": "A picture of the prize, cut out or a photo, any shape."
},
"minItems": 1,
"maxItems": 4,
"title": "Prize pictures",
"description": "One to four pictures of the prize, any shape. Without them, a gift stands in."
},
"prizeValue": {
"type": "number",
"minimum": 0,
"title": "Value",
"description": "What the prize is worth, in the currency below. Shown exactly as sent."
},
"prizeValueLabel": {
"type": "string",
"maxLength": 16,
"title": "Value label",
"description": "The word beside the value, such as Worth."
},
"currency": {
"type": "string",
"maxLength": 3,
"title": "Currency",
"description": "The ISO code the value is in, such as EUR, GBP or USD."
},
"steps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string",
"maxLength": 56,
"title": "Rule",
"description": "What to do."
},
"icon": {
"type": "string",
"enum": [
"check",
"circle-check",
"x",
"arrow-right",
"arrow-up-right",
"plus",
"star",
"heart",
"thumbs-up",
"sparkles",
"zap",
"clock",
"calendar",
"map-pin",
"info",
"triangle-alert",
"lightbulb",
"target",
"award",
"crown",
"gem",
"flame",
"timer",
"list-checks",
"clipboard-check",
"badge-check",
"hand-heart",
"rocket",
"trophy",
"megaphone",
"bell",
"qr-code",
"ticket",
"gift",
"key-round",
"book-open",
"graduation-cap",
"house",
"phone",
"mail",
"globe",
"users",
"user",
"camera",
"video",
"play",
"music",
"mic",
"message-circle",
"share-2",
"bookmark",
"dumbbell",
"footprints",
"palette",
"brush",
"glasses",
"watch",
"mountain",
"plane",
"heart-pulse",
"flower-2",
"moon",
"eye"
],
"title": "Icon",
"description": "A line icon for the rule. Without one, the rule's number stands in.",
"enumNames": [
"Check",
"Circle check",
"X",
"Arrow right",
"Arrow up right",
"Plus",
"Star",
"Heart",
"Thumbs up",
"Sparkles",
"Zap",
"Clock",
"Calendar",
"Map pin",
"Info",
"Triangle alert",
"Lightbulb",
"Target",
"Award",
"Crown",
"Gem",
"Flame",
"Timer",
"List checks",
"Clipboard check",
"Badge check",
"Hand heart",
"Rocket",
"Trophy",
"Megaphone",
"Bell",
"Qr code",
"Ticket",
"Gift",
"Key round",
"Book open",
"Graduation cap",
"House",
"Phone",
"Mail",
"Globe",
"Users",
"User",
"Camera",
"Video",
"Play",
"Music",
"Mic",
"Message circle",
"Share 2",
"Bookmark",
"Dumbbell",
"Footprints",
"Palette",
"Brush",
"Glasses",
"Watch",
"Mountain",
"Plane",
"Heart pulse",
"Flower 2",
"Moon",
"Eye"
]
}
},
"required": [
"text"
],
"additionalProperties": false,
"title": "Rule"
},
"minItems": 2,
"maxItems": 5,
"title": "How to enter",
"description": "Two to five rules, shown one after another; the clip gets a second and a half longer for each."
},
"deadline": {
"type": "string",
"maxLength": 48,
"title": "Deadline",
"description": "When the giveaway closes, as it should be read."
},
"partner": {
"type": "object",
"properties": {
"label": {
"type": "string",
"maxLength": 24,
"title": "Line",
"description": "The words before the partner's name, such as In partnership with."
},
"name": {
"type": "string",
"maxLength": 32,
"title": "Name",
"description": "The partner's name."
},
"logo": {
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"pattern": "^media:\\/\\/[^\\s/\\\\\\u0000-\\u001f][^/\\\\\\u0000-\\u001f]{0,254}$",
"title": "Picture",
"description": "A file from the workspace's media library, written media:// and the file's id or name. A web address is refused."
},
"alt": {
"type": "string",
"maxLength": 120,
"title": "Alt text",
"description": "What the picture shows, for anyone who cannot see it."
}
},
"required": [
"url"
],
"additionalProperties": false,
"title": "Logo",
"description": "The partner's logo, any shape."
}
},
"additionalProperties": false,
"title": "Partner",
"description": "The brand the giveaway is with, shown beside the creator."
},
"cta": {
"type": "object",
"properties": {
"label": {
"type": "string",
"maxLength": 28,
"title": "Button",
"description": "What the button says."
},
"detail": {
"type": "string",
"maxLength": 48,
"title": "Line under it",
"description": "An address, a handle, a phone number."
}
},
"additionalProperties": false,
"title": "Call to action",
"description": "The button at the end and the line under it, such as a web address, a handle or a phone number."
},
"disclaimer": {
"type": "string",
"maxLength": 160,
"title": "Small print",
"description": "The terms that must be shown with a giveaway."
},
"look": {
"type": "object",
"properties": {
"theme": {
"type": "string",
"enum": [
"brand",
"light",
"dark",
"bold"
],
"title": "Theme",
"description": "Brand: your brand's own colours and background. Light or dark: a page tinted with your brand colour. Bold: your brand colour as the page.",
"enumNames": [
"Brand colours",
"Light",
"Dark",
"Bold brand colour"
]
},
"pace": {
"type": "string",
"enum": [
"calm",
"standard",
"punchy"
],
"title": "Pace",
"description": "How things arrive: calm fades, a standard rhythm, or punchy slams and hard cuts.",
"enumNames": [
"Calm",
"Standard",
"Punchy"
]
},
"corners": {
"type": "string",
"enum": [
"square",
"soft",
"round"
],
"title": "Corners",
"description": "The shape of cards, pictures and buttons.",
"enumNames": [
"Square",
"Softly rounded",
"Round"
]
},
"align": {
"type": "string",
"enum": [
"start",
"centre"
],
"title": "Text alignment",
"description": "Where the text lines up.",
"enumNames": [
"At the start of the line",
"Centred"
]
},
"pictureFit": {
"type": "string",
"enum": [
"contain",
"cover"
],
"title": "Prize pictures",
"description": "Cut out: the whole product on a card. Photo: the picture fills its frame.",
"enumNames": [
"Cut out, shown whole",
"Photo, filling the frame"
]
},
"celebrate": {
"type": "boolean",
"title": "Unwrap and confetti",
"description": "The prize is unwrapped like a present and confetti flies, at the start and at the end."
},
"logo": {
"type": "string",
"enum": [
"auto",
"free"
],
"title": "Logo",
"description": "The style's own: the logo on the style's plate (a card, a disc, a badge) so it reads on any page. As it is: the logo whole, with no plate, frame or crop, for a logo made to stand on the page, such as one with a transparent background. As it is, make sure your logo reads on the page of the theme you choose.",
"enumNames": [
"The style's own",
"As it is, no plate or crop"
]
}
},
"additionalProperties": false,
"title": "Look",
"description": "How the clip looks and moves. The same five switches in every format (theme, pace, corners, alignment, logo), plus this format's own. Leave any out for the format's default."
}
},
"additionalProperties": false,
"title": "Clip data",
"description": "Everything drawn in the clip: the prize, the rules, the deadline, the partner and the call to action. The creator is the brand's badge."
},
"metaData": {
"type": "object",
"properties": {
"title": {
"type": "string",
"maxLength": 100,
"title": "Title",
"description": "Used where the platform has a title of its own: Facebook Feed, LinkedIn, Pinterest and YouTube. Up to 100 characters, which every one of them takes."
},
"captionTiny": {
"type": "string",
"maxLength": 200,
"title": "Tiny description (Pinterest, Threads, X)",
"description": "Up to 200 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"captionShort": {
"type": "string",
"maxLength": 500,
"title": "Short description (Telegram, Threema, WeChat, WhatsApp)",
"description": "Up to 500 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"captionMedium": {
"type": "string",
"maxLength": 1500,
"title": "Medium description (Discord, Facebook Reels, Instagram, LinkedIn, Signal, Slack, TikTok)",
"description": "Up to 1500 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"captionLong": {
"type": "string",
"maxLength": 4000,
"title": "Long description (Facebook Feed, YouTube)",
"description": "Up to 4000 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"hashtags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"title": "Hashtag"
},
"maxItems": 15,
"title": "Hashtags",
"description": "Written without the #. Up to 15, which every platform takes."
}
},
"additionalProperties": false,
"title": "Meta data",
"description": "Everything about the post that is never drawn in the clip: its title, its description in four lengths, one per kind of platform, and its hashtags. Reelwire adds the brand's description, link and hashtags after it. Left out, the post text is generated from the clip data."
}
},
"additionalProperties": false
},
"propertyNames": {
"enum": [
"aa",
"ab",
"ae",
"af",
"ak",
"am",
"an",
"ar",
"as",
"av",
"ay",
"az",
"ba",
"be",
"bg",
"bi",
"bm",
"bn",
"bo",
"br",
"bs",
"ca",
"ce",
"ch",
"co",
"cr",
"cs",
"cu",
"cv",
"cy",
"da",
"de",
"dv",
"dz",
"ee",
"el",
"en",
"eo",
"es",
"et",
"eu",
"fa",
"ff",
"fi",
"fj",
"fo",
"fr",
"fy",
"ga",
"gd",
"gl",
"gn",
"gu",
"gv",
"ha",
"he",
"hi",
"ho",
"hr",
"ht",
"hu",
"hy",
"hz",
"ia",
"id",
"ie",
"ig",
"ii",
"ik",
"io",
"is",
"it",
"iu",
"ja",
"jv",
"ka",
"kg",
"ki",
"kj",
"kk",
"kl",
"km",
"kn",
"ko",
"kr",
"ks",
"ku",
"kv",
"kw",
"ky",
"la",
"lb",
"lg",
"li",
"ln",
"lo",
"lt",
"lu",
"lv",
"mg",
"mh",
"mi",
"mk",
"ml",
"mn",
"mr",
"ms",
"mt",
"my",
"na",
"nb",
"nd",
"ne",
"ng",
"nl",
"nn",
"no",
"nr",
"nv",
"ny",
"oc",
"oj",
"om",
"or",
"os",
"pa",
"pi",
"pl",
"ps",
"pt",
"qu",
"rm",
"rn",
"ro",
"ru",
"rw",
"sa",
"sc",
"sd",
"se",
"sg",
"si",
"sk",
"sl",
"sm",
"sn",
"so",
"sq",
"sr",
"ss",
"st",
"su",
"sv",
"sw",
"ta",
"te",
"tg",
"th",
"ti",
"tk",
"tl",
"tn",
"to",
"tr",
"ts",
"tt",
"tw",
"ty",
"ug",
"uk",
"ur",
"uz",
"ve",
"vi",
"vo",
"wa",
"wo",
"xh",
"yi",
"yo",
"za",
"zh",
"zu",
"zh-CN",
"zh-TW",
"pt-BR"
]
}
}
},
"required": [
"clipData"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}
Ask Reelwire for the same document yourself, without signing in:
curl "http://localhost:4000/v1/formats/template/tpl_3245d6e9ee79?variant=Giveaway&version=1.0.0"
Delivery JSON
Your own system sends this to one of your streams, POST /v1/stream, and every channel listening to
that stream draws it with its template. data is the document described above; a stream with an
empty field map passes it to the template unchanged. Try it first on POST /v1/stream/validate,
which answers the same without publishing anything. Streams and feeds
explains the rest, including how to map a document of your own shape instead.
{
"streamId": "st_your_stream_id",
"eventId": "01M2SQMKK3G1NVFXV31DCBVB95",
"occurredAt": "2026-09-23T07:00:00Z",
"locale": "en",
"data": {
"clipData": {
"kicker": "Giveaway time",
"headline": "Win my whole autumn glow kit, all five favourites",
"subline": "Vitamin C serum, SPF 50 fluid, lip oil, cleansing balm and the travel bag",
"pictures": [
{
"alt": "Soft waves of blue, violet and orange",
"url": "media://example-image.jpg"
},
{
"alt": "Hills under an evening sky, drawn in layers",
"url": "media://example-image.svg"
},
{
"alt": "Clouds of red and blue ink in water",
"url": "media://example-image.png"
}
],
"prizeValue": 180,
"prizeValueLabel": "Worth",
"currency": "EUR",
"steps": [
{
"icon": "user",
"text": "Follow @miraglow and @lumiereskin on Instagram"
},
{
"icon": "heart",
"text": "Like this post and save it for later"
},
{
"icon": "users",
"text": "Tag two friends who need a glow-up in the comments"
},
{
"icon": "share-2",
"text": "Share it to your story for a bonus entry"
}
],
"deadline": "Closes Sunday 12 October at 8 pm CET",
"partner": {
"label": "In partnership with",
"name": "Lumiere Skin",
"logo": {
"alt": "The company's logo",
"url": "media://example-logo.png"
}
},
"cta": {
"label": "Enter now",
"detail": "Winner announced Monday in my stories"
},
"disclaimer": "18+, EU residents only, no purchase necessary. Not sponsored or run by Instagram. One winner, full terms in my bio.",
"look": {
"theme": "brand",
"pace": "standard",
"corners": "round",
"align": "start",
"pictureFit": "contain",
"celebrate": true,
"logo": "auto"
}
},
"metaData": {
"title": "Giveaway: win my whole autumn glow kit",
"captionTiny": "Giveaway with Lumiere Skin: win my whole autumn glow kit, worth 180 euros. Closes Sunday 12 October.",
"captionShort": "Giveaway time, together with Lumiere Skin: win my whole autumn glow kit, all five favourites, worth 180 euros. Follow both of us, like and save this post, tag two friends, and share to your story for a bonus entry. Closes Sunday 12 October at 8 pm CET.",
"captionMedium": "Giveaway time, together with Lumiere Skin. One of you wins my whole autumn glow kit, all five favourites: the vitamin C serum, the SPF 50 fluid, the lip oil, the cleansing balm and the travel bag, worth 180 euros. To enter: follow @miraglow and @lumiereskin, like this post and save it, tag two friends who need a glow-up, and share it to your story for a bonus entry. The giveaway closes Sunday 12 October at 8 pm CET, and I announce the winner on Monday in my stories. 18+, EU residents only, no purchase necessary. Not sponsored or run by Instagram.",
"captionLong": "Giveaway time, together with Lumiere Skin, and it is a big one. One of you wins my whole autumn glow kit, all five of the products I have used every single day this season: the vitamin C serum, the SPF 50 fluid, the lip oil, the cleansing balm and the travel bag to carry it all, worth 180 euros together. To enter: follow @miraglow and @lumiereskin on Instagram, like this post and save it for later, tag two friends who need a glow-up in the comments (every comment with two tags counts once), and share it to your story for a bonus entry. The giveaway closes Sunday 12 October at 8 pm CET, and I announce the winner on Monday in my stories and message them from this account only. Please never trust another account that writes to you about a prize. 18+, EU residents only, no purchase necessary. Not sponsored, endorsed or run by Instagram. One winner, full terms in my bio.",
"hashtags": [
"giveaway",
"skincaregiveaway",
"glowkit",
"miraglow",
"lumiereskin"
]
}
}
}
The delivery names no version: which build draws it is the channel's choice, the newest of its
variant or the one it is pinned to. eventId is a ULID you make once per event: sending the same
one again changes nothing. occurredAt is when the thing happened, not when you sent it. locale
is the language of the text in data, and data.locales carries other languages beside it.