> ## Documentation Index
> Fetch the complete documentation index at: https://help.privy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List email templates

> The templates an email draft may start from: the account's own saved newsletter templates,
listed first, and then Privy's gallery. Names and facets only; the design and HTML stay on
the server, and a template is branded for the account only when a draft uses it. Templates
with product blocks are offered only to an account with a connected catalog store. Templates
whose product blocks are personalized (recently viewed, back in stock) are never offered;
other dynamic product templates also need campaign dynamic products, and a WooCommerce store
is not offered ones that use most viewed, as the query or the fallback. HTML-only templates
without an Unlayer design are not offered.

**Required scope:** `campaigns_read`




## OpenAPI

````yaml openapi/privy-api.yaml GET /email_templates
openapi: 3.1.0
info:
  title: Privy API
  version: '1.0'
  description: >
    The Privy API lets you programmatically manage your contact list and read
    what you have set up in Privy.

    Create, update, unsubscribe, and remove contacts; report orders;

    and read your campaigns, flows, segments, orders, store products, coupon
    pools,

    performance reports, and account setup.
servers:
  - url: https://api.privy.com/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Account
    description: Retrieve information about the authenticated Privy account.
  - name: Contacts
    description: Manage your contact list.
  - name: Imports
    description: >-
      Read your contact import history — CSV uploads, connected-provider syncs,
      and SMS consent imports.
  - name: Tags
    description: Read your contact tags — Privy tags and tags synced from Shopify.
  - name: Campaigns
    description: >-
      Read your message campaigns — email and SMS newsletters, plus the messages
      your flows send.
  - name: Displays
    description: >-
      Read your on-site displays (popups, flyouts, banners, embedded forms,
      landing pages).
  - name: Coupons
    description: Read your coupon pools, their code inventory, and individual codes.
  - name: Reports
    description: >-
      Read performance reporting — signups, views, conversion rates, and
      attributed revenue — for your business, displays, and flows.
  - name: Flows
    description: Read your automation flows and their configuration.
  - name: Segments
    description: Read your customer segments and their membership.
  - name: Orders
    description: Report orders placed in your store and read your order history.
  - name: Products
    description: Read the product catalog and collections of your connected store.
  - name: Events
    description: Ingest custom events to trigger Flows and other automations.
paths:
  /email_templates:
    get:
      tags:
        - Campaigns
      summary: List email templates
      description: >
        The templates an email draft may start from: the account's own saved
        newsletter templates,

        listed first, and then Privy's gallery. Names and facets only; the
        design and HTML stay on

        the server, and a template is branded for the account only when a draft
        uses it. Templates

        with product blocks are offered only to an account with a connected
        catalog store. Templates

        whose product blocks are personalized (recently viewed, back in stock)
        are never offered;

        other dynamic product templates also need campaign dynamic products, and
        a WooCommerce store

        is not offered ones that use most viewed, as the query or the fallback.
        HTML-only templates

        without an Unlayer design are not offered.


        **Required scope:** `campaigns_read`
      operationId: listEmailTemplates
      parameters:
        - $ref: '#/components/parameters/AccountIdParam'
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
            minimum: 1
        - name: per_page
          in: query
          required: false
          schema:
            type: integer
            default: 40
            minimum: 10
            maximum: 100
        - name: goal
          in: query
          required: false
          description: >-
            Only gallery templates made for this goal. The account's own saved
            templates carry no goals and stay listed.
          schema:
            type: string
            enum:
              - welcome_contacts
              - announce_sale
              - product_launch
              - re_engage
              - last_chance
              - back_in_stock
        - name: collection
          in: query
          required: false
          description: >-
            Only gallery templates in this collection. The account's own saved
            templates carry no collections and stay listed.
          schema:
            type: string
            enum:
              - bfcm
              - seasonal
              - basic
        - name: source
          in: query
          required: false
          description: >-
            `merchant` for the account's own saved templates, `privy` for
            Privy's gallery.
          schema:
            type: string
            enum:
              - merchant
              - privy
      responses:
        '200':
          description: A paginated list of templates.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/EmailTemplate'
                  pagination:
                    $ref: '#/components/schemas/PaginationEnvelope'
              example:
                data:
                  - id: Xk2fW9qLpV
                    name: Black Friday 2025
                    source: merchant
                    goals:
                      - announce_sale
                    collections:
                      - bfcm
                    tags:
                      - Sales
                    updated_at: '2026-09-01T12:00:00Z'
                pagination:
                  page: 1
                  per_page: 40
                  total_count: 1
                  total_pages: 1
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/InsufficientScope'
        '422':
          $ref: '#/components/responses/ValidationFailed'
        '429':
          $ref: '#/components/responses/RateLimited'
      security:
        - bearerAuth: []
components:
  parameters:
    AccountIdParam:
      name: Privy-Account-Id
      in: header
      required: false
      description: >
        Target a subaccount instead of the main connected account.

        Pass a subaccount `id` from get_account's `subaccounts` list. Only
        direct subaccounts

        of the connected account are reachable — omit this for the main account
        itself.
      schema:
        type: string
      example: S1U2B3A4C5C6T7
  schemas:
    EmailTemplate:
      type: object
      properties:
        id:
          type: string
          description: Stable identifier.
          example: Xk2fW9qLpV
        name:
          type: string
          example: Black Friday 2025
        source:
          type: string
          enum:
            - merchant
            - privy
          description: >-
            `merchant` for the account's own saved templates, `privy` for
            Privy's gallery.
        goals:
          type: array
          items:
            type: string
          example:
            - announce_sale
        collections:
          type: array
          items:
            type: string
          example:
            - bfcm
        tags:
          type: array
          items:
            type: string
          description: Tag names on the template. Privy gallery templates carry none.
        updated_at:
          type: string
          format: date-time
    PaginationEnvelope:
      type: object
      properties:
        page:
          type: integer
          example: 1
        per_page:
          type: integer
          example: 25
        total_count:
          type: integer
          example: 142
        total_pages:
          type: integer
          example: 6
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              enum:
                - invalid_client
                - invalid_scope
                - unauthorized
                - insufficient_scope
                - forbidden
                - paid_plan_required
                - api_access_required
                - segment_builder_required
                - not_found
                - no_connected_store
                - conflict
                - contacts_not_ready
                - validation_failed
                - idempotency_key_reused
                - rate_limited
                - store_unavailable
                - store_rate_limited
                - not_a_draft
                - design_changed
                - sms_missing
                - email_missing
                - ab_test_draft
                - idempotency_key_reused
                - template_unavailable
                - design_unavailable
                - render_failed
              example: validation_failed
            message:
              type: string
              example: One or more fields are invalid
            details:
              type: array
              items:
                type: object
                properties:
                  field:
                    type: string
                    example: email
                  message:
                    type: string
                    example: is required
  responses:
    Unauthorized:
      description: Missing or invalid bearer token.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error:
              code: unauthorized
              message: Bearer token is missing or invalid
    InsufficientScope:
      description: >-
        `insufficient_scope` when the token lacks the required scope for this
        endpoint.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error:
              code: insufficient_scope
              message: Token does not have the required scope
    ValidationFailed:
      description: One or more fields failed validation.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error:
              code: validation_failed
              message: One or more fields are invalid
              details:
                - field: email
                  message: is required
    RateLimited:
      description: Rate limit exceeded. Retry after the specified time.
      headers:
        Retry-After:
          description: Seconds to wait before retrying.
          schema:
            type: integer
          example: 42
        X-RateLimit-Limit-Minute:
          description: Maximum requests allowed per minute.
          schema:
            type: integer
          example: 60
        X-RateLimit-Remaining-Minute:
          description: Requests remaining in the current minute window.
          schema:
            type: integer
          example: 0
        X-RateLimit-Reset-Minute:
          description: Unix timestamp when the minute window resets.
          schema:
            type: integer
          example: 1711929600
        X-RateLimit-Limit-Day:
          description: Maximum requests allowed per day.
          schema:
            type: integer
          example: 10000
        X-RateLimit-Remaining-Day:
          description: Requests remaining in the current day window.
          schema:
            type: integer
          example: 9500
        X-RateLimit-Reset-Day:
          description: Unix timestamp when the day window resets.
          schema:
            type: integer
          example: 1712016000
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error:
              code: rate_limited
              message: Rate limit exceeded
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API token or OAuth access token
      description: >
        Send either an API token or an OAuth access token as

        `Authorization: Bearer <token>`. See the Authentication page for
        details.

````