Intro
Endpoint: https://api.omnisend.com/api/form-templates
Form templates are reusable, brand-styled starting points stored in the brand's library. Use them to render or seed new forms without building content from scratch.
| Endpoint | Description |
|---|---|
GET /api/form-templates | List templates in the brand's library (filterable by displayType) |
GET /api/form-templates/{templateID} | Get a single template with its full content and brand assets applied |
POST /api/form-templates/{templateID}/render | Render a template's display steps as HTML |
Only templates available in the brand's library are returned, each with the brand's assets already applied. A template's content follows the same steps → sections → rows → columns → blocks hierarchy as a form (see the Forms reference).
Constraints and pagination
| Constraint | Value |
|---|---|
| IDs (path parameters) | 24-character hexadecimal |
List page size (limit) | 1–250 (default 100) |
| Templates sort fields | createdAt (default) |
| Sort direction | asc, desc (default) |
List endpoints use cursor-based pagination: pass the after cursor from a response to fetch the next page, or before for the previous page (after and before cannot be combined). See Pagination for details.
Scopes
| Scope | Grants |
|---|---|
forms.read | List and get templates |
forms.write | Render templates |