EmailTemplates

List email templates

Returns the templates on the workspace's Templates page, ordered by id and paginated with cursors. Each item includes the full subject and body. To fetch a single template, call GET /v1/emailTemplate/{id}, which uses the singular emailTemplate.

By default the list returns only active templates. filter[archived]=true returns only archived ones. The list does not include the copies of a template that sequence steps make. To read one of those, call GET /v1/sequenceSteps/{id}?include=template.

There is no name search. Narrow the list with the owner or updatedAt filters, or page through it.

get/emailTemplates

Request

  • Base URL: https://partner-api.nooks.in/v1
  • URL: https://partner-api.nooks.in/v1/emailTemplates
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://oauth.nooks.in/oauth/authorize, token URL https://oauth.nooks.in/oauth/token, scopes: email-templates:read)

Query parameters

page[size]integer

Number of items per page (max 100)

page[after]string

Cursor for fetching the next page. Opaque token returned by the API in links.next; callers should treat it as opaque and only pass values they received from a previous response. Malformed cursors return 400 Bad Request.

page[before]string

Cursor for fetching the previous page. Opaque token returned by the API in links.prev; callers should treat it as opaque and only pass values they received from a previous response. Malformed cursors return 400 Bad Request.

filter[owner][id]string

Returns only templates this user owns. Use a user id from GET /v1/users.

filter[archived]'true' | 'false'

true returns only archived templates. false returns only active ones. The default is false.

filter[updatedAt][gte]string date-time

Filter by minimum updatedAt (ISO 8601 datetime)

filter[updatedAt][lt]string date-time

Filter by updatedAt before this timestamp, exclusive (ISO 8601 datetime)

Response

Successful response

Example response

{
  "data": [
    {
      "id": "ee0e8400-e29b-41d4-a716-446655440080",
      "name": "Initial outreach",
      "subject": "Quick question, {{firstName}}",
      "htmlBody": "<p>Hi {{firstName}},</p><p>...</p>",
      "source": "sep",
      "owner": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "_href": "/v1/sequences/550e8400-e29b-41d4-a716-446655440000"
      },
      "privacy": "team_editable",
      "createdAt": "2025-10-01T10:00:00.000Z",
      "updatedAt": "2025-10-01T10:00:00.000Z"
    }
  ],
  "links": {
    "first": "/v1/sequences?page[size]=50",
    "next": "/v1/sequences?page[size]=50&page[after]=eyJpZCI6IjU1MGU4NDAwLWUyOWItNDFkNC1hNzE2LTQ0NjY1NTQ0MDAwMCIsInYiOjF9"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.