Amazon SES Ses Template API

The Ses Template API from Amazon SES — 5 operation(s) for ses template.

GitHub OpenAPI

Operations 5

POST /?Action=CreateTemplate Create Template #
POST /?Action=DeleteTemplate Delete Template #
POST /?Action=GetTemplate Get Template #
POST /?Action=ListTemplates List Templates #
POST /?Action=UpdateTemplate Update Template #

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/amazon-ses:amazon-ses-template-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

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

OpenAPI Specification

amazon-ses-template-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Amazon Simple Email Service Template API
  version: '2010-12-01'
  description: Generated from AWS's published Smithy model for Amazon Simple Email Service. 5 operation(s).
  contact:
    name: Amazon Web Services
    url: https://aws.amazon.com/contact-us/
  license:
    name: Apache 2.0
    identifier: Apache-2.0
    url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://email.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
paths:
  /?Action=CreateTemplate:
    post:
      operationId: CreateTemplate
      summary: Create Template
      description: Creates an email template. Email templates enable you to send personalized email to one or more destinations
        in a single operation. For more information, see the Amazon SES Developer Guide. You can execute this operation no
        more than once per second.
      responses:
        '200':
          description: Success
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/CreateTemplateResponse'
        '400':
          description: AlreadyExistsException; InvalidTemplateException; LimitExceededException
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/AlreadyExistsException'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              allOf:
              - type: object
                required:
                - Action
                - Version
                properties:
                  Action:
                    type: string
                    const: CreateTemplate
                  Version:
                    type: string
                    const: '2010-12-01'
              - $ref: '#/components/schemas/CreateTemplateRequest'
      tags:
      - Template
  /?Action=DeleteTemplate:
    post:
      operationId: DeleteTemplate
      summary: Delete Template
      description: Deletes an email template. You can execute this operation no more than once per second.
      responses:
        '200':
          description: Success
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/DeleteTemplateResponse'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              allOf:
              - type: object
                required:
                - Action
                - Version
                properties:
                  Action:
                    type: string
                    const: DeleteTemplate
                  Version:
                    type: string
                    const: '2010-12-01'
              - $ref: '#/components/schemas/DeleteTemplateRequest'
      tags:
      - Template
  /?Action=GetTemplate:
    post:
      operationId: GetTemplate
      summary: Get Template
      description: Displays the template object (which includes the Subject line, HTML part and text part) for the template
        you specify. You can execute this operation no more than once per second.
      responses:
        '200':
          description: Success
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/GetTemplateResponse'
        '400':
          description: TemplateDoesNotExistException
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/TemplateDoesNotExistException'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              allOf:
              - type: object
                required:
                - Action
                - Version
                properties:
                  Action:
                    type: string
                    const: GetTemplate
                  Version:
                    type: string
                    const: '2010-12-01'
              - $ref: '#/components/schemas/GetTemplateRequest'
      tags:
      - Template
  /?Action=ListTemplates:
    post:
      operationId: ListTemplates
      summary: List Templates
      description: Lists the email templates present in your Amazon SES account in the current Amazon Web Services Region.
        You can execute this operation no more than once per second.
      responses:
        '200':
          description: Success
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/ListTemplatesResponse'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              allOf:
              - type: object
                required:
                - Action
                - Version
                properties:
                  Action:
                    type: string
                    const: ListTemplates
                  Version:
                    type: string
                    const: '2010-12-01'
              - $ref: '#/components/schemas/ListTemplatesRequest'
      tags:
      - Template
  /?Action=UpdateTemplate:
    post:
      operationId: UpdateTemplate
      summary: Update Template
      description: Updates an email template. Email templates enable you to send personalized email to one or more destinations
        in a single operation. For more information, see the Amazon SES Developer Guide. You can execute this operation no
        more than once per second.
      responses:
        '200':
          description: Success
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/UpdateTemplateResponse'
        '400':
          description: InvalidTemplateException; TemplateDoesNotExistException
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/InvalidTemplateException'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              allOf:
              - type: object
                required:
                - Action
                - Version
                properties:
                  Action:
                    type: string
                    const: UpdateTemplate
                  Version:
                    type: string
                    const: '2010-12-01'
              - $ref: '#/components/schemas/UpdateTemplateRequest'
      tags:
      - Template
components:
  securitySchemes:
    sigv4:
      type: apiKey
      in: header
      name: Authorization
      description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical
        request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
      x-aws-sigv4:
        signingName: ses
  schemas:
    AlreadyExistsException:
      type: object
      properties:
        Name:
          type: string
          description: Indicates that a resource could not be created because the resource name already exists.
        message:
          type: string
    CreateTemplateRequest:
      type: object
      properties:
        Template:
          $ref: '#/components/schemas/Template'
      required:
      - Template
    CreateTemplateResponse:
      type: object
      properties: {}
    DeleteTemplateRequest:
      type: object
      properties:
        TemplateName:
          type: string
          description: The name of the template to be deleted.
      required:
      - TemplateName
    DeleteTemplateResponse:
      type: object
      properties: {}
    GetTemplateRequest:
      type: object
      properties:
        TemplateName:
          type: string
          description: The name of the template to retrieve.
      required:
      - TemplateName
    GetTemplateResponse:
      type: object
      properties:
        Template:
          $ref: '#/components/schemas/Template'
    InvalidTemplateException:
      type: object
      properties:
        TemplateName:
          type: string
        message:
          type: string
    ListTemplatesRequest:
      type: object
      properties:
        NextToken:
          type: string
          description: A token returned from a previous call to ListTemplates to indicate the position in the list of email
            templates.
        MaxItems:
          type: integer
          description: The maximum number of templates to return. This value must be at least 1 and less than or equal to
            100. If more than 100 items are requested, the page size will automatically set to 100. If you do not specify
            a value, 10 is the default page size.
    ListTemplatesResponse:
      type: object
      properties:
        TemplatesMetadata:
          type: array
          items:
            $ref: '#/components/schemas/TemplateMetadata'
          description: An array the contains the name and creation time stamp for each template in your Amazon SES account.
        NextToken:
          type: string
          description: A token indicating that there are additional email templates available to be listed. Pass this token
            to a subsequent call to ListTemplates to retrieve the next set of email templates within your page size.
    Template:
      type: object
      properties:
        TemplateName:
          type: string
          description: The name of the template. You use this name when you send email using the SendTemplatedEmail or SendBulkTemplatedEmail
            operations.
        SubjectPart:
          type: string
          description: The subject line of the email.
        TextPart:
          type: string
          description: The email body that is visible to recipients whose email clients do not display HTML content.
        HtmlPart:
          type: string
          description: The HTML body of the email.
      required:
      - TemplateName
    TemplateDoesNotExistException:
      type: object
      properties:
        TemplateName:
          type: string
        message:
          type: string
    TemplateMetadata:
      type: object
      properties:
        Name:
          type: string
          description: The name of the template.
        CreatedTimestamp:
          type: string
          format: date-time
          description: The time and date the template was created.
    UpdateTemplateRequest:
      type: object
      properties:
        Template:
          $ref: '#/components/schemas/Template'
      required:
      - Template
    UpdateTemplateResponse:
      type: object
      properties: {}
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/3cd98287b471c106254abd89279cc87308d38bfd/models/ses/service/2010-12-01/ses-2010-12-01.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)