TemplateService

Manages message templates with append-only versioning. Templates define the content delivered to campaign recipients.

Methods

Method	Description
`CreateTemplate`	Create a new template
`UpdateTemplate`	Update a template (creates new version)
`GetTemplate`	Get a template by ID
`ListTemplates`	List templates for the organization

CreateTemplate

Create a new template (version 1).

Authorization: Requires MANAGE_TEMPLATES permission

Request: `CreateTemplateRequest`

Field	Type	Description
`name`	`string`	Template name. Max 200 characters.
`body`	`string`	Markdown template content. Max 100,000 characters.
`type`	`TemplateType`	Template type (PUSH, REMINDER, GENERAL).
`variables`	`TemplateVariable[]`	Variable definitions.

Response: `CreateTemplateResponse`

Field	Type	Description
`template`	`Template`	The created template (version 1).

Example

TypeScript (Connect-Web)

const response = await templateClient.createTemplate({
  name: "security-update",
  body: "# Security Update\n\nHi {{name}},\n\nPlease review...",
  type: TemplateType.PUSH,
  variables: [
    { name: "name", source: TemplateVariableSource.AUDIENCE },
  ],
});

Go (gRPC)

resp, err := templateClient.CreateTemplate(ctx, &pidgrv1.CreateTemplateRequest{
    Name: "security-update",
    Body: "# Security Update\n\nHi {{name}},\n\nPlease review...",
    Type: pidgrv1.TemplateType_PUSH,
    Variables: []*pidgrv1.TemplateVariable{
        {Name: "name", Source: pidgrv1.TemplateVariableSource_AUDIENCE},
    },
})

UpdateTemplate

Update a template. Creates a new version — previous versions are preserved.

Authorization: Requires MANAGE_TEMPLATES permission

Request: `UpdateTemplateRequest`

Field	Type	Description
`id`	`string`	Template ID.
`body`	`string`	Updated Markdown content.
`variables`	`TemplateVariable[]`	Updated variable definitions.

Response: `UpdateTemplateResponse`

Field	Type	Description
`template`	`Template`	The updated template with incremented version.

GetTemplate

Authorization: Requires VIEW_TEMPLATES permission

Request: `GetTemplateRequest`

Field	Type	Description
`id`	`string`	Template ID.
`version`	`int32`	Specific version to retrieve. 0 returns latest.

Response: `GetTemplateResponse`

Field	Type	Description
`template`	`Template`	The template.

ListTemplates

Authorization: Requires VIEW_TEMPLATES permission

Request: `ListTemplatesRequest`

Field	Type	Description
`pagination`	`Pagination`	Pagination parameters.

Response: `ListTemplatesResponse`

Field	Type	Description
`templates`	`Template[]`	List of templates (latest versions).
`pagination`	`PaginationMeta`	Pagination metadata.

Template Message

Field	Type	Description
`id`	`string`	Unique identifier.
`name`	`string`	Template name.
`body`	`string`	Markdown content.
`version`	`int32`	Current version number.
`type`	`TemplateType`	Template type.
`variables`	`TemplateVariable[]`	Variable definitions.
`created_at`	`Timestamp`	Creation timestamp.
`updated_at`	`Timestamp`	Last update timestamp.

TemplateVariable

Field	Type	Description
`name`	`string`	Variable name (used in `{{name}}` syntax).
`source`	`TemplateVariableSource`	Where the variable value comes from.

Enums

TemplateType

Value	Description
`PUSH`	Push notification template
`REMINDER`	Reminder template
`GENERAL`	General-purpose template

TemplateVariableSource

Value	Description
`AUDIENCE`	Per-user value from campaign audience
`CUSTOM`	Step-level value from workflow config