Access is invite-only during beta. Once invited, create a key to personalize these examples. Production sending requires a separate review.
Create a template
Create a draft in the dashboard or with the API.
Open Templates, then New template. Name it. Alias is optional. PostShiba generates one from the name when you omit it (Welcome becomes welcome). The alias is the stable template.id you pass when you send.
A new template starts as a draft with a small Liquid example: {{ name }}, an optional button, and global CSS. Edit it, preview it, send a test to a team member, then publish.
Create with the API
create-template.sh
1
curl -sS -X POST \
2
-H 'Authorization: Bearer YOUR_API_KEY' \
3
-H 'Content-Type: application/json' \
4
-d '{
5
"email_template": {
6
"name": "Welcome",
7
"alias": "welcome",
8
"from": "hello@mail.example.com",
9
"subject": "Hi {{ name }}",
10
"html": "<p>Hi {{ name }}</p>",
11
"text": "Hi {{ name }}",
12
"css": "p { color: #18181b; }",
13
"sample_data": {"name": "Ada"}
14
}
15
}' \
16
https://app.postshiba.com/api/v1/teams/KjkAJW/templates
| Field | Required | Notes |
|---|---|---|
name |
Yes | Display name. |
alias |
No | Lowercase letters, numbers, hyphens. Unique per team. |
from |
No | Default From. Overridable at send. |
reply_to |
No | Default Reply-To. |
subject |
No | Liquid. |
html |
No | Liquid HTML. |
text |
No | Liquid plain text. |
css |
No | Global CSS for this template. |
sample_data |
No | JSON object used by the dashboard preview. |
The template is a draft until you publish it.
publish-template.sh
1
curl -sS -X POST \
2
-H 'Authorization: Bearer YOUR_API_KEY' \
3
https://app.postshiba.com/api/v1/templates/welcome/publish