API Reference

Print Mail

Templates

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Create Template

print_mail.templates.create(TemplateCreateParams**kwargs) -> Template

POST/print-mail/v1/templates

Create a template. Note that if you want to create a template that works with our template editor, you must use our dashboard.

ParametersExpand Collapse

description: Optional[str]

An optional string describing this resource. Will be visible in the API and the dashboard.

html: Optional[str]

The HTML content of this template.

metadata: Optional[Dict[str, object]]

See the section on Metadata.

ReturnsExpand Collapse

class Template: …

id: str

A unique ID prefixed with template_

created_at: datetime

The UTC time at which this resource was created.

formatdate-time

live: bool

true if this is a live mode resource else false.

object: Literal["template"]

Always template.

updated_at: datetime

The UTC time at which this resource was last updated.

formatdate-time

description: Optional[str]

An optional string describing this resource. Will be visible in the API and the dashboard.

html: Optional[str]

The HTML content of this template.

metadata: Optional[Dict[str, object]]

See the section on Metadata.

Create Template

Python

HTTP

TypeScript

Python

import os
from postgrid import PostGrid

client = PostGrid(
    print_mail_api_key=os.environ.get("POSTGRID_PRINT_MAIL_API_KEY"),  # This is the default and can be omitted
)
template = client.print_mail.templates.create(
    description="Test",
    html="<b>Hello</b> {{to.firstName}}",
)
print(template.id)

201 example

{
  "id": "template_tBnVEzz878mXLbHQaz86j8",
  "object": "template",
  "live": false,
  "description": "Test",
  "html": "<b>Hello</b> {{to.firstName}}!",
  "createdAt": "2020-11-12T23:23:47.974Z",
  "updatedAt": "2020-11-12T23:23:47.974Z"
}

Returns Examples

201 example

{
  "id": "template_tBnVEzz878mXLbHQaz86j8",
  "object": "template",
  "live": false,
  "description": "Test",
  "html": "<b>Hello</b> {{to.firstName}}!",
  "createdAt": "2020-11-12T23:23:47.974Z",
  "updatedAt": "2020-11-12T23:23:47.974Z"
}