Benchmark Email

Benchmark Email Email Template API

Email template related endpoints

GitHub OpenAPI

Operations 3

GET /api/email/template Get email templates #
GET /api/email/template/categories Get email template categories #
GET /api/email/template/{id} Get email template by ID #

Documentation

📖
Documentation
https://developers.benchmarkemail.io/
📖
APIReference
https://developers.benchmarkemail.io/api-reference
📖
GettingStarted
https://developers.benchmarkemail.io/introduction
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/benchmark-email/refs/heads/main/authentication/benchmark-email-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/benchmark-email/refs/heads/main/rate-limits/benchmark-email-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/benchmark-email/refs/heads/main/openapi/benchmark-email-email-template-api-openapi.yml

Other Resources

🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/benchmark-email/refs/heads/main/scopes/benchmark-email-scopes.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/benchmark-email/refs/heads/main/errors/benchmark-email-problem-types.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/benchmark-email/refs/heads/main/conventions/benchmark-email-conventions.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/benchmark-email/refs/heads/main/data-model/benchmark-email-data-model.yml
🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/benchmark-email/refs/heads/main/mcp/benchmark-email-tool-crosswalk.yml
🔗
AgentCard
https://raw.githubusercontent.com/api-evangelist/benchmark-email/refs/heads/main/a2a/benchmark-email-a2a.yml
🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/benchmark-email/refs/heads/main/llms/benchmark-email-llms.txt

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/benchmark-email-email-template-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

benchmark-email-email-template-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: 'Public REST API for Benchmark Email.


    Authenticate every request by including your API key in the `X-API-Key` header.

    Each key is issued with one or more scopes that control which endpoints it may call.


    Rate limits: 60 requests per minute per account.

    Monthly quota: determined by your subscription plan.'
  title: Benchmark Email Email Template API
  version: 1.0.0
servers:
- description: Your account's API base URL. Copy the full URL shown on Settings > API Keys in your Benchmark Email account and paste it here.
  url: '{apiBaseUrl}'
  variables:
    apiBaseUrl:
      default: ''
      description: Your account's API base URL. Copy it from Settings > API Keys in your Benchmark Email account.
security:
- apiKeyAuth: []
tags:
- description: Email template related endpoints
  name: email-template
paths:
  /api/email/template:
    get:
      description: Get email templates with optional filters
      operationId: get_api_email_template
      parameters:
      - description: Language code
        in: query
        name: lang
        required: true
        schema:
          type: string
      - description: Search term to filter templates
        in: query
        name: searchTerm
        schema:
          type: string
      - description: Template attribute IDs to filter by
        example:
        - 6b1234567890123456789012
        explode: false
        in: query
        name: attributeIds
        schema:
          items:
            type: string
          type: array
      - description: Flag to retrieve only internal templates (by default false)
        example: true
        in: query
        name: internal
        schema:
          type: boolean
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  records:
                    items:
                      properties:
                        attributeIds:
                          items:
                            description: Template category attribute IDs
                            type: string
                          type: array
                        id:
                          description: Template ID
                          type: string
                        imageUrl:
                          description: Template image URL
                          type: string
                        lang:
                          description: Language code
                          type: string
                        name:
                          description: Template name
                          type: string
                        order:
                          description: Display order (ascending, 1-indexed). Present only when explicitly assigned.
                          minimum: 1
                          type: integer
                        subject:
                          description: Template subject
                          type: string
                        unlayerId:
                          description: Template Unlayer ID
                          type: string
                      type: object
                    type: array
                  total:
                    description: Total number of templates
                    type: number
                type: object
          description: Successful operation
        '400':
          description: Bad request
        '401':
          description: Unauthorized
        '500':
          description: Internal server error
      security:
      - apiKeyAuth: []
      summary: Get email templates
      tags:
      - email-template
      x-api-key-scope: campaigns:read
  /api/email/template/categories:
    get:
      description: Get all email template categories
      operationId: getEmailTemplateCategories
      parameters:
      - description: Language code
        in: query
        name: lang
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  records:
                    description: List of template categories
                    items:
                      properties:
                        attributes:
                          description: List of attributes in this category
                          items:
                            properties:
                              categoryId:
                                description: Parent category ID
                                type: string
                              id:
                                description: Attribute ID
                                type: string
                              lang:
                                description: Language code
                                type: string
                              order:
                                description: Attribute display order
                                type: integer
                              value:
                                description: Attribute display value
                                type: string
                            type: object
                          type: array
                        id:
                          description: Category ID
                          type: string
                        lang:
                          description: Language code
                          type: string
                        name:
                          description: Category name
                          type: string
                        order:
                          description: Category display order
                          type: integer
                      type: object
                    type: array
                  total:
                    description: Total number of categories
                    type: integer
                type: object
          description: Successful operation
        '400':
          description: Bad request
        '401':
          description: Unauthorized
        '500':
          description: Internal server error
      security:
      - apiKeyAuth: []
      summary: Get email template categories
      tags:
      - email-template
      x-api-key-scope: campaigns:read
  /api/email/template/{id}:
    get:
      description: Get an email template by its ID
      operationId: get_api_email_template_by_id
      parameters:
      - in: path
        name: id
        required: true
        schema:
          type: string
      - description: Language code
        in: query
        name: lang
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  attributeIds:
                    items:
                      description: Template category attribute IDs
                      type: string
                    type: array
                  design:
                    description: Unlayer JSON of the template
                    type: string
                  html:
                    description: HTML body of the template
                    type: string
                  id:
                    description: Template ID
                    type: string
                  imageUrl:
                    description: Template image URL
                    type: string
                  lang:
                    description: Language code
                    type: string
                  name:
                    description: Template name
                    type: string
                  order:
                    description: Display order (ascending, 1-indexed). Present only when explicitly assigned.
                    minimum: 1
                    type: integer
                  subject:
                    description: Template subject
                    type: string
                  unlayerId:
                    description: Template Unlayer ID
                    type: string
                type: object
          description: Successful operation
        '401':
          description: Unauthorized
        '500':
          description: Internal server error
      security:
      - apiKeyAuth: []
      summary: Get email template by ID
      tags:
      - email-template
      x-api-key-scope: campaigns:read
components:
  securitySchemes:
    apiKeyAuth:
      description: API key authentication
      in: header
      name: X-API-Key
      type: apiKey