Access is invite-only during beta. Once invited, create a key to personalize these examples. Production sending requires a separate review.
Templates
Hosted Liquid templates.
Hosted Liquid templates. Create a draft, edit HTML, text, subject, and global CSS, then publish. Send with template.id (alias or public id) and a variables object. Drafts cannot send. Editing a published template keeps the published snapshot live until you publish again. CSS is injected and inlined at send time. id on member routes is the public id or the alias.
GET /api/v1/teams/:obfuscated_team_id/templates
List templates.
request.sh
1
curl -sS -X GET \
2
-H 'Authorization: Bearer YOUR_API_KEY' \
3
https://app.postshiba.com/api/v1/teams/KjkAJW/templates
response.json
1
[
2
{
3
"id": "TpLmQr",
4
"name": "Welcome",
5
"alias": "welcome",
6
"from": "hello@mail.example.com",
7
"reply_to": null,
8
"subject": "Hi {{ name }}",
9
"html": "<p>Hi {{ name }}</p>",
10
"text": "Hi {{ name }}",
11
"css": "p { color: #18181b; }",
12
"sample_data": {
13
"name": "Ada"
14
},
15
"published": true,
16
"published_at": "2026-09-11T12:00:00.000Z",
17
"has_unpublished_changes": false,
18
"created_at": "2026-09-11T12:00:00.000Z",
19
"updated_at": "2026-09-11T12:00:00.000Z"
20
}
21
]
GET /api/v1/templates/:id
Get one template by public id or alias. Returns the current draft fields.
id: Public template id or alias
request.sh
1
curl -sS -X GET \
2
-H 'Authorization: Bearer YOUR_API_KEY' \
3
https://app.postshiba.com/api/v1/templates/:email_template_id
response.json
1
{
2
"id": "TpLmQr",
3
"name": "Welcome",
4
"alias": "welcome",
5
"from": "hello@mail.example.com",
6
"reply_to": null,
7
"subject": "Hi {{ name }}",
8
"html": "<p>Hi {{ name }}</p>",
9
"text": "Hi {{ name }}",
10
"css": "p { color: #18181b; }",
11
"sample_data": {
12
"name": "Ada"
13
},
14
"published": true,
15
"published_at": "2026-09-11T12:00:00.000Z",
16
"has_unpublished_changes": false,
17
"created_at": "2026-09-11T12:00:00.000Z",
18
"updated_at": "2026-09-11T12:00:00.000Z"
19
}
POST /api/v1/teams/:obfuscated_team_id/templates
Create a draft template. Alias is generated from name when omitted.
request.sh
1
curl -sS -X POST \
2
-H 'Authorization: Bearer YOUR_API_KEY' \
3
-H 'Content-Type: application/json' \
4
-d '{"email_template":{"name":"Welcome","alias":"welcome","from":"hello@mail.example.com","subject":"Hi {{ name }}","html":"\u003cp\u003eHi {{ name }}\u003c/p\u003e","text":"Hi {{ name }}","css":"p { color: #18181b; }","sample_data":{"name":"Ada"}}}' \
5
https://app.postshiba.com/api/v1/teams/KjkAJW/templates
response.json
1
{
2
"id": "TpLmQr",
3
"name": "Welcome",
4
"alias": "welcome",
5
"from": "hello@mail.example.com",
6
"reply_to": null,
7
"subject": "Hi {{ name }}",
8
"html": "<p>Hi {{ name }}</p>",
9
"text": "Hi {{ name }}",
10
"css": "p { color: #18181b; }",
11
"sample_data": {
12
"name": "Ada"
13
},
14
"published": true,
15
"published_at": "2026-09-11T12:00:00.000Z",
16
"has_unpublished_changes": false,
17
"created_at": "2026-09-11T12:00:00.000Z",
18
"updated_at": "2026-09-11T12:00:00.000Z"
19
}
PATCH /api/v1/templates/:id
Update draft fields. The published snapshot is unchanged until you publish.
id: Public template id or alias
request.sh
1
curl -sS -X PATCH \
2
-H 'Authorization: Bearer YOUR_API_KEY' \
3
-H 'Content-Type: application/json' \
4
-d '{"email_template":{"subject":"Welcome, {{ name }}"}}' \
5
https://app.postshiba.com/api/v1/templates/:email_template_id
response.json
1
{
2
"id": "TpLmQr",
3
"name": "Welcome",
4
"alias": "welcome",
5
"from": "hello@mail.example.com",
6
"reply_to": null,
7
"subject": "Welcome, {{ name }}",
8
"html": "<p>Hi {{ name }}</p>",
9
"text": "Hi {{ name }}",
10
"css": "p { color: #18181b; }",
11
"sample_data": {
12
"name": "Ada"
13
},
14
"published": true,
15
"published_at": "2026-09-11T12:00:00.000Z",
16
"has_unpublished_changes": true,
17
"created_at": "2026-09-11T12:00:00.000Z",
18
"updated_at": "2026-09-11T12:00:00.000Z"
19
}
POST /api/v1/templates/:id/publish
Publish the current draft. Sends use this snapshot until the next publish.
id: Public template id or alias
request.sh
1
curl -sS -X POST \
2
-H 'Authorization: Bearer YOUR_API_KEY' \
3
-H 'Content-Type: application/json' \
4
https://app.postshiba.com/api/v1/templates/:email_template_id/publish
response.json
1
{
2
"id": "TpLmQr",
3
"name": "Welcome",
4
"alias": "welcome",
5
"from": "hello@mail.example.com",
6
"reply_to": null,
7
"subject": "Hi {{ name }}",
8
"html": "<p>Hi {{ name }}</p>",
9
"text": "Hi {{ name }}",
10
"css": "p { color: #18181b; }",
11
"sample_data": {
12
"name": "Ada"
13
},
14
"published": true,
15
"published_at": "2026-09-11T12:00:00.000Z",
16
"has_unpublished_changes": false,
17
"created_at": "2026-09-11T12:00:00.000Z",
18
"updated_at": "2026-09-11T12:00:00.000Z"
19
}
POST /api/v1/templates/:id/duplicate
Copy the draft into a new unpublished template.
id: Public template id or alias
request.sh
1
curl -sS -X POST \
2
-H 'Authorization: Bearer YOUR_API_KEY' \
3
-H 'Content-Type: application/json' \
4
https://app.postshiba.com/api/v1/templates/:email_template_id/duplicate
response.json
1
{
2
"id": "TpLmQr",
3
"name": "Welcome copy",
4
"alias": "welcome-copy",
5
"from": "hello@mail.example.com",
6
"reply_to": null,
7
"subject": "Hi {{ name }}",
8
"html": "<p>Hi {{ name }}</p>",
9
"text": "Hi {{ name }}",
10
"css": "p { color: #18181b; }",
11
"sample_data": {
12
"name": "Ada"
13
},
14
"published": false,
15
"published_at": null,
16
"has_unpublished_changes": false,
17
"created_at": "2026-09-11T12:00:00.000Z",
18
"updated_at": "2026-09-11T12:00:00.000Z"
19
}
request.sh
1
curl -sS -X DELETE \
2
-H 'Authorization: Bearer YOUR_API_KEY' \
3
https://app.postshiba.com/api/v1/templates/:email_template_id