Encharge

Encharge Email Templates API

The Email Templates API from Encharge — 7 operation(s) for email templates.

GitHub OpenAPI
Business capability
Digital Marketing Management BC-400.60

Operations 9

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /emails/{id} Get an email template · Get email #
Ask an LLM
“How do I fetch an email template's content and settings?”
“What subject and sender does a given email template use?”
Tell an agent
Get email template {id}.
Show me the email template {id}.
PATCH /emails/{id} Modify an email template · Modify email #
Ask an LLM
“How do I change the subject line of an existing email template?”
“Can I archive an email template instead of deleting it?”
Tell an agent
Change the subject of email template {id} to {subject}.
Archive email template {id}.
DELETE /emails/{id} Delete an email template · Delete email #
Ask an LLM
“How do I delete an email template I don't use anymore?”
“Can I permanently remove an email template?”
Tell an agent destructive · confirm first
Delete email template {id}.
Remove the email template {id} from my account.
POST /emails Create an email template · Create email #
Ask an LLM
“How do I create a new email template with HTML content?”
“Can I set a reply-to address and preheader on a new template?”
Tell an agent
Create an email template {name} with subject {subject} from {fromEmail}.
Create template {name}, subject {subject}, sent from {fromEmail}, with this HTML: {html}.
GET /emails/{id}/versions List an email template's version history · Get email versions #
Ask an LLM
“How do I see the past versions of an email template?”
“Can I page through an email template's edit history?”
Tell an agent
List the version history of email template {id}.
Show the last {limit} versions of template {id}.
GET /emails/{id}/versions/{version} Get a specific email template version · Get email version #
Ask an LLM
“How do I view what an email template looked like in an earlier version?”
“Can I fetch one particular version number of a template?”
Tell an agent
Get version {version} of email template {id}.
Show template {id} as it was at version {version}.
GET /emails/{id}/versions/selected Get the currently selected template version · Get selected email version #
Ask an LLM
“Which version of an email template is currently selected?”
“How do I check the active version of a template?”
Tell an agent
Get the currently selected version of email template {id}.
Tell me which version of template {id} is active right now.
PATCH /emails/{id}/versions/latest Update the latest version of a template · Update latest email version #
Ask an LLM
“How do I edit the newest version of an email template's HTML?”
“Can I change only the latest draft version of a template?”
Tell an agent
Update the latest version of template {id} with this HTML: {html}.
Set the preheader on the latest version of template {id} to {preheader}.
POST /emails/{id}/versions/{version}/restore Restore an earlier template version · Restore email version #
Ask an LLM
“How do I roll an email template back to an older version?”
“Can I make a previous version the current email content again?”
Tell an agent
Restore version {version} of email template {id}.
Roll template {id} back to version {version}.

Specifications

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

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/encharge:encharge-email-templates-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

encharge-email-templates-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 1.0.0
  title: Encharge Email Templates API
  description: The Encharge.io API
  license:
    name: MIT
  contact:
    url: https://help.encharge.io
    name: unknown
servers:
- url: https://api.encharge.io/v1
tags:
- name: Email Templates
paths:
  /emails/{id}:
    get:
      operationId: GetEmail
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                properties:
                  email: {}
                required:
                - email
                type: object
      description: Get email template
      tags:
      - Email Templates
      security:
      - oauth2:
        - emails:read
      parameters:
      - in: path
        name: id
        required: true
        schema:
          format: double
          type: number
      summary: Get email
      x-summary-source: derived
    patch:
      operationId: ModifyEmail
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                properties:
                  email:
                    $ref: '#/components/schemas/EmailContent'
                required:
                - email
                type: object
      description: Modify email template
      tags:
      - Email Templates
      security:
      - oauth2:
        - emails:write
      parameters:
      - in: path
        name: id
        required: true
        schema:
          format: double
          type: number
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Partial_IEmailContent_'
      summary: Modify email
      x-summary-source: derived
    delete:
      operationId: DeleteEmail
      responses:
        '204':
          description: Deleted
      description: Delete email template
      tags:
      - Email Templates
      security:
      - oauth2:
        - emails:write
      parameters:
      - in: path
        name: id
        required: true
        schema:
          format: double
          type: number
      summary: Delete email
      x-summary-source: derived
  /emails:
    post:
      operationId: CreateEmail
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                properties:
                  email:
                    $ref: '#/components/schemas/EmailContent'
                required:
                - email
                type: object
      description: Create email template
      tags:
      - Email Templates
      security:
      - oauth2:
        - emails:write
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EmailContentCreate'
      summary: Create email
      x-summary-source: derived
  /emails/{id}/versions:
    get:
      operationId: GetEmailVersions
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                properties:
                  versions:
                    items:
                      $ref: '#/components/schemas/EmailContentVersion'
                    type: array
                required:
                - versions
                type: object
      description: Get version history for an email template
      tags:
      - Email Templates
      security:
      - oauth2:
        - emails:read
      parameters:
      - in: path
        name: id
        required: true
        schema:
          format: double
          type: number
      - in: query
        name: limit
        required: false
        schema:
          default: 50
          format: double
          type: number
      - in: query
        name: offset
        required: false
        schema:
          default: 0
          format: double
          type: number
      summary: Get email versions
      x-summary-source: derived
  /emails/{id}/versions/{version}:
    get:
      operationId: GetEmailVersion
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                properties:
                  version:
                    $ref: '#/components/schemas/EmailContentVersion'
                required:
                - version
                type: object
      description: Get a specific version of an email template
      tags:
      - Email Templates
      security:
      - oauth2:
        - emails:read
      parameters:
      - in: path
        name: id
        required: true
        schema:
          format: double
          type: number
      - in: path
        name: version
        required: true
        schema:
          format: double
          type: number
      summary: Get email version
      x-summary-source: derived
  /emails/{id}/versions/selected:
    get:
      operationId: GetSelectedEmailVersion
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                properties:
                  version:
                    $ref: '#/components/schemas/EmailContentVersion'
                required:
                - version
                type: object
      description: Get the currently selected version for an email template
      tags:
      - Email Templates
      security:
      - oauth2:
        - emails:read
      parameters:
      - in: path
        name: id
        required: true
        schema:
          format: double
          type: number
      summary: Get selected email version
      x-summary-source: derived
  /emails/{id}/versions/latest:
    patch:
      operationId: UpdateLatestEmailVersion
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                properties:
                  version:
                    $ref: '#/components/schemas/EmailContentVersion'
                  email:
                    $ref: '#/components/schemas/EmailContent'
                required:
                - version
                - email
                type: object
      description: Update the latest version of an email template
      tags:
      - Email Templates
      security:
      - oauth2:
        - emails:write
      parameters:
      - in: path
        name: id
        required: true
        schema:
          format: double
          type: number
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Partial_IEmailContent_'
      summary: Update latest email version
      x-summary-source: derived
  /emails/{id}/versions/{version}/restore:
    post:
      operationId: RestoreEmailVersion
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                properties:
                  newVersion:
                    $ref: '#/components/schemas/EmailContentVersion'
                  restoredFromVersion:
                    type: number
                    format: double
                  email:
                    $ref: '#/components/schemas/EmailContent'
                required:
                - newVersion
                - restoredFromVersion
                - email
                type: object
      description: Restore a specific version as the current email content
      tags:
      - Email Templates
      security:
      - oauth2:
        - emails:write
      parameters:
      - in: path
        name: id
        required: true
        schema:
          format: double
          type: number
      - in: path
        name: version
        required: true
        schema:
          format: double
          type: number
      summary: Restore email version
      x-summary-source: derived
components:
  schemas:
    EmailContent: {}
    EmailContentVersion: {}
    Partial_IEmailContent_:
      properties:
        id:
          type: number
          format: double
        archived:
          type: boolean
        isStandalone:
          type: boolean
        accountId:
          type: number
          format: double
        name:
          type: string
        subject:
          type: string
        fromEmail:
          type: string
        fromName:
          type: string
        replyName:
          type: string
        replyEmail:
          type: string
        type:
          type: string
          enum:
          - HTML
          - text
        html:
          type: string
        editor: {}
        previewImage:
          type: string
        preheader:
          type: string
        cc:
          type: string
        bcc:
          type: string
        canSpamCompliance:
          type: string
          enum:
          - approved
          - pending
          - rejected
          - manually_approved
        communicationCategoryId:
          type: number
          format: double
        mergeTags:
          $ref: '#/components/schemas/EmailMergeTags'
        aiGenerated:
          type: boolean
      type: object
      description: Make all properties in T optional
    EmailContentCreate:
      properties:
        name:
          type: string
          description: Name of the email template
        subject:
          type: string
          description: Subject of the email.
        fromEmail:
          type: string
          description: From address to send the email from
        fromName:
          type: string
          description: Name that most inboxes use to display instead of the From email address.
        replyEmail:
          type: string
          description: Address that recipients will reply to by default.
        replyName:
          type: string
          description: Name that most inboxes use to display instead of the Reply email address.
        type:
          type: string
          enum:
          - HTML
          - text
          description: Type of the email. HTML or plain-text. Currently only HTML is supported.
        html:
          type: string
          description: HTML content of the email.
        editor:
          description: Internal representation of the email template to enable editing in the Encharge UI.
        previewImage:
          type: string
          description: Thumbnail of the email contents
        preheader:
          type: string
          description: The preheader is a summary text that follows a subject line when the email is viewed in an inbox.
        cc:
          type: string
          description: CC recipients of this email. Please note that using CC in mass emails is not advised, as it will quickly flood the CCed inbox.
        bcc:
          type: string
          description: BCC recipients of this email. Please note that using BCC in mass emails is not advised, as it will quickly flood the BCCed inbox.
        communicationCategoryId:
          type: number
          format: double
          description: The category of this email template
        mergeTags:
          items:
            properties:
              label:
                type: string
              value:
                type: string
            required:
            - value
            type: object
          type: array
          description: Custom merge tags for the email
        isStandalone:
          type: boolean
          description: Whether this email template is standalone or part of a broadcast.
        aiGenerated:
          type: boolean
          description: Whether this email template was generated by the AI assistant.
      required:
      - name
      - subject
      - fromEmail
      type: object
      additionalProperties: false
    EmailMergeTags:
      items:
        $ref: '#/components/schemas/EmailMergeTag'
      type: array
    EmailMergeTag:
      properties:
        value:
          type: string
        label:
          type: string
      required:
      - value
      type: object
      additionalProperties: false
  securitySchemes:
    apiKeyHeader:
      description: "You can use API key authentication if you are using the API for your Encharge account. If you are building an app for others to use, please use the OAuth2 authentication below. Find your API key from https://app.encharge.io/account/info . \n\n While all operations in the API specify oauth2 security, instead you can use an API key in the header or query string."
      type: apiKey
      in: header
      name: X-Encharge-Token
    apiKeyQuery:
      description: "You can use API key authentication if you are using the API for your Encharge account. \n\nIf you are building an app for others to use, please use the OAuth2 authentication below. Find your API key from https://app.encharge.io/account/info \n\n While all operations in the API specify oauth2 security, instead you can use an API key in the header or query string."
      type: apiKey
      in: query
      name: token
    oauth2:
      type: oauth2
      description: "The Encharge API uses OAuth 2 with the authorization code flow. \n\nGet for your OAuth credentials (Client ID and Client Secret) by filling out [this form](https://research.typeform.com/to/I680YtLA)."
      flows:
        authorizationCode:
          authorizationUrl: https://api.encharge.io/v1/oauth/authorize
          tokenUrl: https://api.encharge.io/v1/oauth/token
          refreshUrl: https://api.encharge.io/v1/oauth/token
          scopes: {}