bird email templates versions languages set
Usage
Code example
bird email templates versions languages set <template-ref> <version-id> <language> [flags]Description
Upsert one language of a draft
Save one language's full content on a template's draft, creating the language if the draft does not have it yet. The response carries compatibility: what the saved HTML uses that mail clients remove, ignore, or render inconsistently, each finding naming the pattern, its line and column, and what to use instead. Advisory: the language is saved either way, and compatibility_severity of problem means part of the content does nothing at all in the clients the finding names.
Build the request from flags, a JSON EmailTemplateLanguageUpsert body via --body-file ("-" reads
stdin), or both — a flag overrides the matching body field. Run --example to
print a ready-to-edit body, or --dry-run to print the resolved request without
sending it.
Procedure
Step 2 of 3 of "Author a template and make it sendable". Previous: bird email templates create. Next: bird email templates versions submit.
Examples
Code example
# print the body shape (no credentials needed)
bird email templates versions languages set --example
# the body it prints:Code example
{
"html": "<h1>Hi {{ bird.contact.first_name }}</h1>",
"preview_text": "{{ bird.contact.first_name }}, your order is on its way",
"subject": "Welcome to Acme, {{ bird.contact.first_name }}!"
}Options
Request
| Name | Description |
|---|---|
| --body-file | Read the JSON request body from this file; "-" reads stdin |
| --example | Print a complete example request body, then exit |
| --dry-run | Print the resolved request without sending it, then exit |
| --idempotency-key | Deduplication key; a retry with the same key won't act twice |
Options
| Name | Description |
|---|---|
| --subject | The email subject line for this language. (required; or in --body-file) |
| --preview-text | The line an inbox shows after the subject in the message list. Leave it out and the inbox shows the opening words of the body instead. |
| --html | The HTML body for this language. |
| --text | The plain-text body for this language. Omit it and a plain-text alternative is derived from the HTML when you submit. |
| --revision <n> | The revision you last read for this language, to detect a concurrent edit. The save is rejected with a conflict if the language moved on since. Omit it to save unconditionally. Creating a language does not need one. |
| --response-schema | Print the fields this command returns, then exit |
Related
| Name | Description |
|---|---|
| bird email templates versions languages delete | Delete one language from a draft |
| bird email templates versions languages get | Get one language of a version |
| bird email templates versions languages list | List a version's languages |
| bird email templates versions languages update | Update one language of a draft |
Related resources
Continue with the documentation, guides and examples for this topic. Resources are in English.
Watch the guideHow to build an email templateExplore the capabilityEmail templatesFollow the learning pathBuild your first integrationImplementation guideEmail templates
Try the practice and get an implementation brief