Amazon SES

Amazon SES Email API

The Email API from Amazon SES — 60 operation(s) for email.

GitHub OpenAPI

Operations 86

POST /v2/email/metrics/batch Batch get metric data #
POST /v2/email/configuration-sets Create configuration set #
GET /v2/email/configuration-sets List configuration sets #
POST /v2/email/configuration-sets/{ConfigurationSetName}/event-destinations Create configuration set event destination #
GET /v2/email/configuration-sets/{ConfigurationSetName}/event-destinations Get configuration set event destinations #
POST /v2/email/contact-lists/{ContactListName}/contacts Create contact #
GET /v2/email/contact-lists/{ContactListName}/contacts List contacts #
POST /v2/email/contact-lists Create contact list #
GET /v2/email/contact-lists List contact lists #
POST /v2/email/custom-verification-email-templates Create custom verification email template #
GET /v2/email/custom-verification-email-templates List custom verification email templates #
POST /v2/email/dedicated-ip-pools Create dedicated ip pool #
GET /v2/email/dedicated-ip-pools List dedicated ip pools #
POST /v2/email/deliverability-dashboard/test Create deliverability test report #
POST /v2/email/identities Create email identity #
GET /v2/email/identities List email identities #
POST /v2/email/identities/{EmailIdentity}/policies/{PolicyName} Create email identity policy #
DELETE /v2/email/identities/{EmailIdentity}/policies/{PolicyName} Delete email identity policy #
PUT /v2/email/identities/{EmailIdentity}/policies/{PolicyName} Update email identity policy #
POST /v2/email/templates Create email template #
GET /v2/email/templates List email templates #
POST /v2/email/import-jobs Create import job #
GET /v2/email/import-jobs List import jobs #
DELETE /v2/email/configuration-sets/{ConfigurationSetName} Delete configuration set #
GET /v2/email/configuration-sets/{ConfigurationSetName} Get configuration set #
DELETE /v2/email/configuration-sets/{ConfigurationSetName}/event-destinations/{EventDestinationName} Delete configuration set event destination #
PUT /v2/email/configuration-sets/{ConfigurationSetName}/event-destinations/{EventDestinationName} Update configuration set event destination #
DELETE /v2/email/contact-lists/{ContactListName}/contacts/{EmailAddress} Delete contact #
GET /v2/email/contact-lists/{ContactListName}/contacts/{EmailAddress} Get contact #
PUT /v2/email/contact-lists/{ContactListName}/contacts/{EmailAddress} Update contact #
DELETE /v2/email/contact-lists/{ContactListName} Delete contact list #
GET /v2/email/contact-lists/{ContactListName} Get contact list #
PUT /v2/email/contact-lists/{ContactListName} Update contact list #
DELETE /v2/email/custom-verification-email-templates/{TemplateName} Delete custom verification email template #
GET /v2/email/custom-verification-email-templates/{TemplateName} Get custom verification email template #
PUT /v2/email/custom-verification-email-templates/{TemplateName} Update custom verification email template #
DELETE /v2/email/dedicated-ip-pools/{PoolName} Delete dedicated ip pool #
GET /v2/email/dedicated-ip-pools/{PoolName} Get dedicated ip pool #
DELETE /v2/email/identities/{EmailIdentity} Delete email identity #
GET /v2/email/identities/{EmailIdentity} Get email identity #
DELETE /v2/email/templates/{TemplateName} Delete email template #
GET /v2/email/templates/{TemplateName} Get email template #
PUT /v2/email/templates/{TemplateName} Update email template #
DELETE /v2/email/suppression/addresses/{EmailAddress} Delete suppressed destination #
GET /v2/email/suppression/addresses/{EmailAddress} Get suppressed destination #
GET /v2/email/account Get account #
GET /v2/email/deliverability-dashboard/blacklist-report#BlacklistItemNames Get blacklist reports #
GET /v2/email/dedicated-ips/{IP} Get dedicated ip #
GET /v2/email/dedicated-ips Get dedicated ips #
GET /v2/email/deliverability-dashboard Get deliverability dashboard options #
PUT /v2/email/deliverability-dashboard Put deliverability dashboard option #
GET /v2/email/deliverability-dashboard/test-reports/{ReportId} Get deliverability test report #
GET /v2/email/deliverability-dashboard/campaigns/{CampaignId} Get domain deliverability campaign #
GET /v2/email/deliverability-dashboard/statistics-report/{Domain}#StartDate&EndDate Get domain statistics report #
GET /v2/email/identities/{EmailIdentity}/policies Get email identity policies #
GET /v2/email/import-jobs/{JobId} Get import job #
GET /v2/email/deliverability-dashboard/test-reports List deliverability test reports #
GET /v2/email/deliverability-dashboard/domains/{SubscribedDomain}/campaigns#StartDate&EndDate List domain deliverability campaigns #
POST /v2/email/vdm/recommendations List recommendations #
GET /v2/email/suppression/addresses List suppressed destinations #
PUT /v2/email/suppression/addresses Put suppressed destination #
GET /v2/email/tags#ResourceArn List tags for resource #
PUT /v2/email/account/dedicated-ips/warmup Put account dedicated ip warmup attributes #
POST /v2/email/account/details Put account details #
PUT /v2/email/account/sending Put account sending attributes #
PUT /v2/email/account/suppression Put account suppression attributes #
PUT /v2/email/account/vdm Put account vdm attributes #
PUT /v2/email/configuration-sets/{ConfigurationSetName}/delivery-options Put configuration set delivery options #
PUT /v2/email/configuration-sets/{ConfigurationSetName}/reputation-options Put configuration set reputation options #
PUT /v2/email/configuration-sets/{ConfigurationSetName}/sending Put configuration set sending options #
PUT /v2/email/configuration-sets/{ConfigurationSetName}/suppression-options Put configuration set suppression options #
PUT /v2/email/configuration-sets/{ConfigurationSetName}/tracking-options Put configuration set tracking options #
PUT /v2/email/configuration-sets/{ConfigurationSetName}/vdm-options Put configuration set vdm options #
PUT /v2/email/dedicated-ips/{IP}/pool Put dedicated ip in pool #
PUT /v2/email/dedicated-ips/{IP}/warmup Put dedicated ip warmup attributes #
PUT /v2/email/identities/{EmailIdentity}/configuration-set Put email identity configuration set attributes #
PUT /v2/email/identities/{EmailIdentity}/dkim Put email identity dkim attributes #
PUT /v1/email/identities/{EmailIdentity}/dkim/signing Put email identity dkim signing attributes #
PUT /v2/email/identities/{EmailIdentity}/feedback Put email identity feedback attributes #
PUT /v2/email/identities/{EmailIdentity}/mail-from Put email identity mail from attributes #
POST /v2/email/outbound-bulk-emails Send bulk email #
POST /v2/email/outbound-custom-verification-emails Send custom verification email #
POST /v2/email/outbound-emails Send email #
POST /v2/email/tags Tag resource #
POST /v2/email/templates/{TemplateName}/render Test render email template #
DELETE /v2/email/tags#ResourceArn&TagKeys Untag resource #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/amazon-ses/refs/heads/main/openapi/amazon-ses-email-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/amazon-ses-email-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

amazon-ses-email-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 2019-09-27
  x-release: v4
  title: Amazon Simple Service Email API
  description: 'Amazon SES API v2

    Amazon SES is an Amazon Web Services service that you can use to send email messages to your customers.


    If you''re new to Amazon SES API v2, you might find it helpful to review the Amazon Simple Email Service Developer Guide. The Amazon SES Developer Guide provides information and code samples that demonstrate how to use Amazon SES API v2 features programmatically.'
  x-logo:
    url: https://api.apis.guru/v2/cache/logo/https_twitter.com_awscloud_profile_image.png
    backgroundColor: '#FFFFFF'
  termsOfService: https://aws.amazon.com/service-terms/
  contact:
    name: Mike Ralphson
    email: mike.ralphson@gmail.com
    url: https://github.com/mermade/aws2openapi
    x-twitter: PermittedSoc
  license:
    name: Apache 2.0 License
    url: http://www.apache.org/licenses/
  x-providerName: amazonaws.com
  x-serviceName: sesv2
  x-aws-signingName: ses
  x-origin:
  - contentType: application/json
    url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/sesv2-2019-09-27.normal.json
    converter:
      url: https://github.com/mermade/aws2openapi
      version: 1.0.0
    x-apisguru-driver: external
  x-apiClientRegistration:
    url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct
  x-apisguru-categories:
  - cloud
  x-preferred: true
servers:
- url: http://email.{region}.amazonaws.com
  variables:
    region:
      description: The AWS region
      enum:
      - us-east-1
      - us-east-2
      - us-west-1
      - us-west-2
      - us-gov-west-1
      - us-gov-east-1
      - ca-central-1
      - eu-north-1
      - eu-west-1
      - eu-west-2
      - eu-west-3
      - eu-central-1
      - eu-south-1
      - af-south-1
      - ap-northeast-1
      - ap-northeast-2
      - ap-northeast-3
      - ap-southeast-1
      - ap-southeast-2
      - ap-east-1
      - ap-south-1
      - sa-east-1
      - me-south-1
      default: us-east-1
  description: The Amazon SES V2 multi-region endpoint
- url: https://email.{region}.amazonaws.com
  variables:
    region:
      description: The AWS region
      enum:
      - us-east-1
      - us-east-2
      - us-west-1
      - us-west-2
      - us-gov-west-1
      - us-gov-east-1
      - ca-central-1
      - eu-north-1
      - eu-west-1
      - eu-west-2
      - eu-west-3
      - eu-central-1
      - eu-south-1
      - af-south-1
      - ap-northeast-1
      - ap-northeast-2
      - ap-northeast-3
      - ap-southeast-1
      - ap-southeast-2
      - ap-east-1
      - ap-south-1
      - sa-east-1
      - me-south-1
      default: us-east-1
  description: The Amazon SES V2 multi-region endpoint
- url: http://email.{region}.amazonaws.com.cn
  variables:
    region:
      description: The AWS region
      enum:
      - cn-north-1
      - cn-northwest-1
      default: cn-north-1
  description: The Amazon SES V2 endpoint for China (Beijing) and China (Ningxia)
- url: https://email.{region}.amazonaws.com.cn
  variables:
    region:
      description: The AWS region
      enum:
      - cn-north-1
      - cn-northwest-1
      default: cn-north-1
  description: The Amazon SES V2 endpoint for China (Beijing) and China (Ningxia)
security:
- hmac: []
tags:


# --- truncated at 32 KB (387 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/amazon-ses/refs/heads/main/openapi/amazon-ses-email-api-openapi.yml