Preview a broadcast for a contact

Select this template. Changing the ID clears the old language, parameters and parameter overrides before supplied replacements. Repeating the same ID retains those values and clears the selected template version, so the next preparation uses the template's latest published version. Omit id to retain the selected template. Adding parameters to a draft created before parameters existed may clear its selected version so it uses the template's latest published version. To clear a draft's selection, set template itself to null.

The BCP-47 language tag that goes to the whole audience, such as en or pt-BR. It must be an exact match for a language on the template's published version, so fr-CA does not select fr. Leave it out to keep the language already selected. If you change the template id in the same request, the old language is cleared with the old template. Set this to null to use the published version's default language, unless the template has language_source_required set.

Complete template input map. Each value is a string, number, boolean or null and is used exactly as given, so text containing braces or code-like syntax is never evaluated. Objects and lists are not accepted. Use bird.contact.first_name in the template for contact data. Names must be bare input names outside the bird namespace. Omission retains the map unless the template ID changes, which clears it; an empty object clears it, and null is invalid. The compact map is limited to 16384 UTF-8 bytes and 128 names. Individual email parameters keep their own format.

Complete map of per-language parameter values, keyed by a BCP-47 language tag of at most 35 characters such as es or pt-BR. Each language holds only the names whose value differs for that language; a name it leaves out uses the value in parameters, including later changes to it. A value that is present always applies, even when it is "", 0, false, null or equal to the parameters value. To return a name to the parameters value, send the map without it. Sending this map, even as {}, applies language rules to the broadcast: parameters must hold every input the default language's content, sender name, reply-to or headers use, and an input only the selected language uses may come from that language's entry instead. A broadcast that never sends it keeps the selected-language rules. Values for the default language, or for a language the broadcast does not send, are kept but not used. Omission retains the map unless the template ID changes, which clears it; an empty object removes every override, null is invalid and a language with no names is removed. Tags are stored in canonical BCP-47 form, so two spellings of one tag are refused. The compact map is limited to 16384 UTF-8 bytes, and parameters and every language together are limited to 128 distinct names.