designing-email-templates

Call workflows-create-email-template with a name, subject, and content containing the Unlayer design JSON plus a plain-text version. The server renders the HTML from the design, and the result includes an edit link to open the template in PostHog.

Fetch the current template with workflows-get-email-template, modify the returned design, then send the complete content back via workflows-update-email-template. For small changes, use workflows-patch-email-template with id-addressed operations instead.

Yes, email content uses Liquid templating and tags pass through the renderer as plain text. Use variables like {{ person.properties.first_name | default: 'there' }} in block text, subjects, and links, always with default fallbacks.

First list existing images with media-images-list using purpose="email". For new images, use the presigned upload flow: media-image-upload-start, POST the file via curl, then media-image-upload-complete to get the permanent URL. Images must be under 4MB.

Every link is rewritten through a click-tracking redirect, which breaks mobile universal links that must stay on their own domain. Mark the anchor tag with clicktracking="off" or data-ph-no-track to keep it untracked, accepting that it gets no click metrics.