{"openapi":"3.0.0","info":{"description":"Amazon Simple Email Service (SES) v2 API for sending transactional and bulk emails, managing email identities, templates, contact lists, configuration sets, and suppression lists","version":[{"name":"v2","value":"v2"}]},"servers":[{"description":"Amazon Simple Email Service (SES) v2 API for sending transactional and bulk emails, managing email identities, templates, contact lists, configuration sets, and suppression lists","url":"https://api.apirails.com/awsses"}],"paths":{"/v2/email/outbound-emails":{"post":{"tags":["Email Sending"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/outbound-emails"},"summary":"Send Email","description":"Sends an email using Amazon SES v2. Supports simple messages, raw MIME, and templated emails with attachments, custom headers, and list management.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"ConfigurationSetName":{"type":"string","description":"Configuration set for tracking and compliance"},"Content":{"type":"object","description":"Email content - choose one of Simple, Raw, or Template","required":true,"properties":{"Raw":{"type":"object","description":"Raw MIME-formatted email message"},"Simple":{"type":"object","description":"Simple email message with subject and body"},"Template":{"type":"object","description":"Templated email using an SES template"}}},"Destination":{"type":"object","description":"Destination addresses for the email","properties":{"BccAddresses":{"type":"array","description":"List of blind carbon copy email addresses"},"CcAddresses":{"type":"array","description":"List of carbon copy email addresses"},"ToAddresses":{"type":"array","description":"List of recipient email addresses in the To field"}}},"EmailTags":{"type":"array","description":"Tags attached to the email for tracking","items":{"type":"object","properties":{"Name":{"type":"string","description":"Tag name (max 256 chars)"},"Value":{"type":"string","description":"Tag value (max 256 chars)"}}}},"EndpointId":{"type":"string","description":"Multi-region endpoint ID for cross-region sending"},"FeedbackForwardingEmailAddress":{"type":"string","description":"Email address that receives bounces and complaints"},"FeedbackForwardingEmailAddressIdentityArn":{"type":"string","description":"ARN of the identity for feedback forwarding"},"FromEmailAddress":{"type":"string","description":"Verified sender email address"},"FromEmailAddressIdentityArn":{"type":"string","description":"ARN of the identity for sending authorization"},"ListManagementOptions":{"type":"object","description":"Options for managing list subscriptions","properties":{"ContactListName":{"type":"string","description":"Name of the contact list"},"TopicName":{"type":"string","description":"Topic name within the contact list"}}},"ReplyToAddresses":{"type":"array","description":"List of reply-to email addresses","items":{"type":"string"}}}},"example":{"ConfigurationSetName":["my-config-set"],"Content":{},"Destination":{},"EmailTags":[{"Name":"campaign","Value":"welcome-series"}],"EndpointId":["endpoint-abc123"],"FeedbackForwardingEmailAddress":["feedback@example.com"],"FeedbackForwardingEmailAddressIdentityArn":["arn:aws:ses:us-east-1:123456789012:identity/example.com"],"FromEmailAddress":["sender@example.com","noreply@mydomain.com"],"FromEmailAddressIdentityArn":["arn:aws:ses:us-east-1:123456789012:identity/example.com"],"ListManagementOptions":{},"ReplyToAddresses":[["reply@example.com"]]}}}}}},"/v2/email/outbound-bulk-emails":{"post":{"tags":["Email Sending"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/outbound-bulk-emails"},"summary":"Send Bulk Email","description":"Sends templated bulk emails to multiple recipients. Each recipient can have unique destination, template data, tags, and headers.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"BulkEmailEntries":{"type":"array","description":"Array of individual bulk email entries with per-recipient overrides","required":true,"items":{"type":"object","properties":{"Destination":{"type":"object","description":"Destination addresses for this specific recipient","required":true},"ReplacementHeaders":{"type":"array","description":"Per-recipient custom headers"},"ReplacementTags":{"type":"array","description":"Per-recipient message tags"},"ReplacementTemplateData":{"type":"string","description":"Per-recipient template replacement data (JSON string)"}}}},"ConfigurationSetName":{"type":"string","description":"Configuration set for tracking and compliance"},"DefaultContent":{"type":"object","description":"Default content template for all bulk recipients","required":true,"properties":{"Template":{"type":"object","description":"Template specification for the bulk send","required":true}}},"DefaultEmailTags":{"type":"array","description":"Default tags for all emails in the bulk send","items":{"type":"object","properties":{"Name":{"type":"string","description":"Tag name"},"Value":{"type":"string","description":"Tag value"}}}},"EndpointId":{"type":"string","description":"Multi-region endpoint ID"},"FeedbackForwardingEmailAddress":{"type":"string","description":"Email receiving bounces and complaints"},"FromEmailAddress":{"type":"string","description":"Verified sender email address"},"FromEmailAddressIdentityArn":{"type":"string","description":"ARN of the identity for sending authorization"},"ReplyToAddresses":{"type":"array","description":"Default reply-to addresses","items":{"type":"string"}}}},"example":{"BulkEmailEntries":[{"Destination":{"ToAddresses":["recipient1@example.com"]},"ReplacementTemplateData":"{\"name\":\"Alice\"}"}],"ConfigurationSetName":["bulk-config-set"],"DefaultContent":{},"DefaultEmailTags":[{"Name":"campaign","Value":"summer-promo"}],"EndpointId":["endpoint-bulk-xyz"],"FeedbackForwardingEmailAddress":["complaints@example.com"],"FromEmailAddress":["marketing@example.com"],"FromEmailAddressIdentityArn":["arn:aws:ses:us-east-1:123456789012:identity/example.com"],"ReplyToAddresses":[["reply@example.com"]]}}}}}},"/v2/email/outbound-custom-verification-emails":{"post":{"tags":["Email Sending"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendCustomVerificationEmail.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/outbound-custom-verification-emails"},"summary":"Send Custom Verification Email","description":"Sends a custom verification email. The recipient must click the link to verify ownership before using the address for sending.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"ConfigurationSetName":{"type":"string","description":"Configuration set for the verification email"},"EmailAddress":{"type":"string","description":"Email address to verify","required":true},"TemplateName":{"type":"string","description":"Name of the custom verification email template"}}},"example":{"ConfigurationSetName":["verification-config-set"],"EmailAddress":["newuser@example.com"],"TemplateName":["MyVerificationTemplate"]}}}}}},"/v2/email/identities":{"post":{"tags":["Email Identity"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateEmailIdentity.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/identities"},"summary":"Create Email Identity","description":"Starts verifying an email identity (address or domain). Returns DKIM tokens for domain verification.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"ConfigurationSetName":{"type":"string","description":"Default configuration set when sending from this identity"},"DkimSigningAttributes":{"type":"object","description":"DKIM signing attributes for BYODKIM or Easy DKIM","properties":{"DomainSigningAttributesOrigin":{"type":"string","description":"Origin of the domain signing attributes","enum":["AWS_SES","EXTERNAL"]},"DomainSigningPrivateKey":{"type":"string","description":"Private key for BYODKIM signing"},"DomainSigningSelector":{"type":"string","description":"Selector for the DKIM DNS record"},"NextSigningKeyLength":{"type":"string","description":"Key length for the next signing key","enum":["RSA_1024_BIT","RSA_2048_BIT","RSA_4096_BIT"]}}},"EmailIdentity":{"type":"string","description":"The email address or domain to verify","required":true},"Tags":{"type":"array","description":"Tags to associate with the email identity","items":{"type":"object","properties":{"Key":{"type":"string","description":"Tag key"},"Value":{"type":"string","description":"Tag value"}}}}}},"example":{"ConfigurationSetName":["my-config-set"],"DkimSigningAttributes":{},"EmailIdentity":["example.com","sender@example.com"],"Tags":[{"Key":"environment","Value":"production"}]}}}}},"get":{"tags":["Email Identity"],"parameters":[{"name":"NextToken","in":"query","description":"Pagination token from a previous call","required":false,"schema":{"type":"string","example":""}},{"name":"PageSize","in":"query","description":"Number of results per page (0-1000)","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListEmailIdentities.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/identities"},"summary":"List Email Identities","description":"Returns a list of all email identities associated with your account, including verified and unverified addresses and domains.","security":[{"bearerAuth":[]}]}},"/v2/email/identities/{EmailIdentity}":{"get":{"tags":["Email Identity"],"parameters":[{"name":"EmailIdentity","in":"path","description":"The email address or domain identity","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetEmailIdentity.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/identities/{EmailIdentity}"},"summary":"Get Email Identity","description":"Returns information about a specific identity including verification status, DKIM attributes, and Mail-From settings.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Email Identity"],"parameters":[{"name":"EmailIdentity","in":"path","description":"The email address or domain identity to delete","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_DeleteEmailIdentity.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/identities/{EmailIdentity}"},"summary":"Delete Email Identity","description":"Deletes an email identity (address or domain) from your account.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/email/templates":{"post":{"tags":["Email Templates"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateEmailTemplate.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/templates"},"summary":"Create Email Template","description":"Creates an email template with subject, HTML, and text parts. Max 1 request per second.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"Tags":{"type":"array","description":"Tags to associate with the template","items":{"type":"object","properties":{"Key":{"type":"string","description":"Tag key"},"Value":{"type":"string","description":"Tag value"}}}},"TemplateContent":{"type":"object","description":"The content of the email template","required":true,"properties":{"Html":{"type":"string","description":"HTML content with optional {{variables}}"},"Subject":{"type":"string","description":"Subject line with optional {{variables}}"},"Text":{"type":"string","description":"Plain text content with optional {{variables}}"}}},"TemplateName":{"type":"string","description":"The name of the template","required":true}}},"example":{"Tags":[{"Key":"type","Value":"onboarding"}],"TemplateContent":{},"TemplateName":["WelcomeTemplate"]}}}}},"get":{"tags":["Email Templates"],"parameters":[{"name":"NextToken","in":"query","description":"Pagination token from a previous call","required":false,"schema":{"type":"string","example":""}},{"name":"PageSize","in":"query","description":"Number of results per page (1-100)","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListEmailTemplates.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/templates"},"summary":"List Email Templates","description":"Lists all email templates in your account. Max 1 request per second.","security":[{"bearerAuth":[]}]}},"/v2/email/templates/{TemplateName}":{"get":{"tags":["Email Templates"],"parameters":[{"name":"TemplateName","in":"path","description":"The name of the template","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetEmailTemplate.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/templates/{TemplateName}"},"summary":"Get Email Template","description":"Displays the template object including subject, HTML, and text parts. Max 50 requests per second.","security":[{"bearerAuth":[]}]},"put":{"tags":["Email Templates"],"parameters":[{"name":"TemplateName","in":"path","description":"The name of the template to update","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateEmailTemplate.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/templates/{TemplateName}"},"summary":"Update Email Template","description":"Updates an existing email template content. Max 1 request per second.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"TemplateContent":{"type":"object","description":"The updated content of the email template","required":true,"properties":{"Html":{"type":"string","description":"HTML content with optional {{variables}}"},"Subject":{"type":"string","description":"Subject line with optional {{variables}}"},"Text":{"type":"string","description":"Plain text content with optional {{variables}}"}}}}},"example":{"TemplateContent":{}}}}}},"delete":{"tags":["Email Templates"],"parameters":[{"name":"TemplateName","in":"path","description":"The name of the template to delete","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_DeleteEmailTemplate.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/templates/{TemplateName}"},"summary":"Delete Email Template","description":"Deletes an email template. Max 1 request per second.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/email/templates/{TemplateName}/render":{"post":{"tags":["Email Templates"],"parameters":[{"name":"TemplateName","in":"path","description":"The name of the template to render","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_TestRenderEmailTemplate.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/templates/{TemplateName}/render"},"summary":"Test Render Email Template","description":"Creates a preview of the MIME content by rendering a template with replacement data. Max 1 request per second.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"TemplateData":{"type":"string","description":"JSON string of replacement data to apply to the template","required":true}}},"example":{"TemplateData":["{\"name\":\"John\",\"order_id\":\"ORD-12345\"}"]}}}}}},"/v2/email/suppression/addresses":{"put":{"tags":["Suppression List"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_PutSuppressedDestination.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/suppression/addresses"},"summary":"Add Suppressed Destination","description":"Adds an email address to the suppression list for your account or a specific tenant.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"EmailAddress":{"type":"string","description":"The email address to add to the suppression list","required":true},"Reason":{"type":"string","description":"The reason for suppression","required":true,"enum":["BOUNCE","COMPLAINT"]},"TenantName":{"type":"string","description":"Tenant name for multi-tenant suppression (omit for account-level)"}}},"example":{"EmailAddress":["bounce@bad-domain.com"],"Reason":["BOUNCE"],"TenantName":["tenant-abc"]}}}}},"get":{"tags":["Suppression List"],"parameters":[{"name":"EndDate","in":"query","description":"Filter to addresses added before this date (ISO 8601 timestamp)","required":false,"schema":{"type":"string","example":""}},{"name":"NextToken","in":"query","description":"Pagination token from a previous call","required":false,"schema":{"type":"string","example":""}},{"name":"PageSize","in":"query","description":"Number of results per page","required":false,"schema":{"type":"number","example":""}},{"name":"Reasons","in":"query","description":"Filter by suppression reason","required":false,"schema":{"type":"string","example":"","items":{"type":"string","enum":["BOUNCE","COMPLAINT"]}}},{"name":"StartDate","in":"query","description":"Filter to addresses added after this date (ISO 8601 timestamp)","required":false,"schema":{"type":"string","example":""}},{"name":"TenantName","in":"query","description":"Tenant name for multi-tenant suppression list","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListSuppressedDestinations.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/suppression/addresses"},"summary":"List Suppressed Destinations","description":"Lists email addresses on the suppression list. Supports filtering by reason and date range.","security":[{"bearerAuth":[]}]}},"/v2/email/suppression/addresses/{EmailAddress}":{"get":{"tags":["Suppression List"],"parameters":[{"name":"EmailAddress","in":"path","description":"The suppressed email address to look up","required":true,"schema":{"type":"string","example":""}},{"name":"TenantName","in":"query","description":"Tenant name for multi-tenant suppression list","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetSuppressedDestination.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/suppression/addresses/{EmailAddress}"},"summary":"Get Suppressed Destination","description":"Retrieves information about a suppressed email address including reason and last update time.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Suppression List"],"parameters":[{"name":"EmailAddress","in":"path","description":"The suppressed email address to remove","required":true,"schema":{"type":"string","example":""}},{"name":"TenantName","in":"query","description":"Tenant name for multi-tenant suppression list","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_DeleteSuppressedDestination.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/suppression/addresses/{EmailAddress}"},"summary":"Delete Suppressed Destination","description":"Removes an email address from the suppression list for your account or a specific tenant.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/email/configuration-sets":{"post":{"tags":["Configuration Sets"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateConfigurationSet.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/configuration-sets"},"summary":"Create Configuration Set","description":"Creates a configuration set with rules for email delivery, tracking, reputation, and suppression.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"ConfigurationSetName":{"type":"string","description":"The name of the configuration set (max 64 chars, alphanumeric/hyphens/underscores)","required":true},"DeliveryOptions":{"type":"object","description":"Delivery options for the configuration set","properties":{"MaxDeliverySeconds":{"type":"number","description":"Maximum time for email delivery in seconds"},"SendingPoolName":{"type":"string","description":"Name of the dedicated IP pool"},"TlsPolicy":{"type":"string","description":"TLS policy for email delivery","enum":["REQUIRE","OPTIONAL"]}}},"ReputationOptions":{"type":"object","description":"Reputation metrics options","properties":{"ReputationMetricsEnabled":{"type":"boolean","description":"Whether to collect reputation metrics","enum":[true,false]}}},"SendingOptions":{"type":"object","description":"Sending options for the configuration set","properties":{"SendingEnabled":{"type":"boolean","description":"Whether sending is enabled for this configuration set","enum":[true,false]}}},"SuppressionOptions":{"type":"object","description":"Suppression list preferences","properties":{"SuppressedReasons":{"type":"array","description":"Reasons for suppressing emails"},"SuppressionScope":{"type":"string","description":"Suppression scope for this configuration set","enum":["ACCOUNT","TENANT"]}}},"Tags":{"type":"array","description":"Tags to associate with the configuration set","items":{"type":"object","properties":{"Key":{"type":"string","description":"Tag key"},"Value":{"type":"string","description":"Tag value"}}}},"TrackingOptions":{"type":"object","description":"Open and click tracking options","properties":{"CustomRedirectDomain":{"type":"string","description":"Custom domain for open and click tracking redirects"},"HttpsPolicy":{"type":"string","description":"HTTPS policy for tracking redirects","enum":["REQUIRE","ENABLED","DISABLED"]}}}}},"example":{"ConfigurationSetName":["my-config-set"],"DeliveryOptions":{},"ReputationOptions":{},"SendingOptions":{},"SuppressionOptions":{},"Tags":[{"Key":"environment","Value":"production"}],"TrackingOptions":{}}}}}},"get":{"tags":["Configuration Sets"],"parameters":[{"name":"NextToken","in":"query","description":"Pagination token from a previous call","required":false,"schema":{"type":"string","example":""}},{"name":"PageSize","in":"query","description":"Number of results per page","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListConfigurationSets.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/configuration-sets"},"summary":"List Configuration Sets","description":"Lists all configuration sets associated with your account in the current region.","security":[{"bearerAuth":[]}]}},"/v2/email/configuration-sets/{ConfigurationSetName}":{"get":{"tags":["Configuration Sets"],"parameters":[{"name":"ConfigurationSetName","in":"path","description":"The name of the configuration set","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetConfigurationSet.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/configuration-sets/{ConfigurationSetName}"},"summary":"Get Configuration Set","description":"Returns information about a configuration set including delivery options, tracking, sending status, and reputation settings.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Configuration Sets"],"parameters":[{"name":"ConfigurationSetName","in":"path","description":"The name of the configuration set to delete","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_DeleteConfigurationSet.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/configuration-sets/{ConfigurationSetName}"},"summary":"Delete Configuration Set","description":"Deletes an existing configuration set.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/email/contact-lists":{"post":{"tags":["Contacts"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContactList.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/contact-lists"},"summary":"Create Contact List","description":"Creates a contact list with optional topics (interest groups) for subscriber management.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"ContactListName":{"type":"string","description":"The name of the contact list","required":true},"Description":{"type":"string","description":"A description of the contact list"},"Tags":{"type":"array","description":"Tags to associate with the contact list","items":{"type":"object","properties":{"Key":{"type":"string","description":"Tag key"},"Value":{"type":"string","description":"Tag value"}}}},"Topics":{"type":"array","description":"Topics (interest groups) within the contact list","items":{"type":"object","properties":{"DefaultSubscriptionStatus":{"type":"string","description":"Default subscription status for new contacts","enum":["OPT_IN","OPT_OUT"]},"Description":{"type":"string","description":"Description of the topic"},"DisplayName":{"type":"string","description":"Display name for the topic"},"TopicName":{"type":"string","description":"Topic name identifier"}}}}}},"example":{"ContactListName":["newsletter-subscribers"],"Description":["Weekly newsletter subscriber list"],"Tags":[{"Key":"type","Value":"newsletter"}],"Topics":[{"DefaultSubscriptionStatus":"OPT_IN","Description":"Weekly digest emails","DisplayName":"Weekly Digest","TopicName":"weekly-digest"}]}}}}},"get":{"tags":["Contacts"],"parameters":[{"name":"NextToken","in":"query","description":"Pagination token from a previous call","required":false,"schema":{"type":"string","example":""}},{"name":"PageSize","in":"query","description":"Number of contact lists to return per page","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContactLists.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/contact-lists"},"summary":"List Contact Lists","description":"Lists all contact lists in your account with their names and last update timestamps.","security":[{"bearerAuth":[]}]}},"/v2/email/contact-lists/{ContactListName}":{"get":{"tags":["Contacts"],"parameters":[{"name":"ContactListName","in":"path","description":"The name of the contact list","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetContactList.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/contact-lists/{ContactListName}"},"summary":"Get Contact List","description":"Returns contact list metadata including topics, description, and tags. Does not return contacts.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Contacts"],"parameters":[{"name":"ContactListName","in":"path","description":"The name of the contact list to delete","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_DeleteContactList.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/contact-lists/{ContactListName}"},"summary":"Delete Contact List","description":"Deletes a contact list and all of the contacts on that list.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/email/contact-lists/{ContactListName}/contacts":{"post":{"tags":["Contacts"],"parameters":[{"name":"ContactListName","in":"path","description":"The name of the contact list","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContact.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/contact-lists/{ContactListName}/contacts"},"summary":"Create Contact","description":"Creates a contact and adds them to a contact list with optional topic preferences and attributes.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"AttributesData":{"type":"string","description":"Attribute data for the contact (JSON string)"},"EmailAddress":{"type":"string","description":"The contact's email address","required":true},"TopicPreferences":{"type":"array","description":"Topic subscription preferences for the contact","items":{"type":"object","properties":{"SubscriptionStatus":{"type":"string","description":"Subscription status for the topic","enum":["OPT_IN","OPT_OUT"]},"TopicName":{"type":"string","description":"Topic name"}}}},"UnsubscribeAll":{"type":"boolean","description":"Whether the contact is unsubscribed from all topics","enum":[true,false]}}},"example":{"AttributesData":["{\"name\":\"John\",\"city\":\"NYC\"}"],"EmailAddress":["user@example.com"],"TopicPreferences":[{"SubscriptionStatus":"OPT_IN","TopicName":"weekly-digest"}],"UnsubscribeAll":[false]}}}}}},"/v2/email/contact-lists/{ContactListName}/contacts/{EmailAddress}":{"get":{"tags":["Contacts"],"parameters":[{"name":"ContactListName","in":"path","description":"The name of the contact list","required":true,"schema":{"type":"string","example":""}},{"name":"EmailAddress","in":"path","description":"The contact's email address","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetContact.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/contact-lists/{ContactListName}/contacts/{EmailAddress}"},"summary":"Get Contact","description":"Returns a contact's details including topic preferences, attributes, and subscription status.","security":[{"bearerAuth":[]}]},"put":{"tags":["Contacts"],"parameters":[{"name":"ContactListName","in":"path","description":"The name of the contact list","required":true,"schema":{"type":"string","example":""}},{"name":"EmailAddress","in":"path","description":"The contact's email address","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateContact.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/contact-lists/{ContactListName}/contacts/{EmailAddress}"},"summary":"Update Contact","description":"Updates a contact's preferences. Must specify all existing topic preferences or they will be removed.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"AttributesData":{"type":"string","description":"Updated attribute data (JSON string)"},"TopicPreferences":{"type":"array","description":"Updated topic preferences (must include ALL existing preferences)","items":{"type":"object","properties":{"SubscriptionStatus":{"type":"string","description":"Subscription status","enum":["OPT_IN","OPT_OUT"]},"TopicName":{"type":"string","description":"Topic name"}}}},"UnsubscribeAll":{"type":"boolean","description":"Whether the contact is unsubscribed from all topics","enum":[true,false]}}},"example":{"AttributesData":["{\"name\":\"John\",\"city\":\"LA\"}"],"TopicPreferences":[{"SubscriptionStatus":"OPT_OUT","TopicName":"weekly-digest"}],"UnsubscribeAll":[false]}}}}},"delete":{"tags":["Contacts"],"parameters":[{"name":"ContactListName","in":"path","description":"The name of the contact list","required":true,"schema":{"type":"string","example":""}},{"name":"EmailAddress","in":"path","description":"The contact's email address to remove","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_DeleteContact.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/contact-lists/{ContactListName}/contacts/{EmailAddress}"},"summary":"Delete Contact","description":"Removes a contact from a contact list.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/email/contact-lists/{ContactListName}/contacts/list":{"post":{"tags":["Contacts"],"parameters":[{"name":"ContactListName","in":"path","description":"The name of the contact list","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/contact-lists/{ContactListName}/contacts/list"},"summary":"List Contacts","description":"Lists contacts in a contact list. Supports filtering by subscription status and topic. Note: this is a POST endpoint.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"Filter":{"type":"object","description":"Filter for contacts list","properties":{"FilteredStatus":{"type":"string","description":"Filter by subscription status","enum":["OPT_IN","OPT_OUT"]},"TopicFilter":{"type":"object","description":"Filter by topic preference"}}},"NextToken":{"type":"string","description":"Pagination token from a previous call"},"PageSize":{"type":"number","description":"Number of contacts per page"}}},"example":{"Filter":{},"NextToken":["abc123token"],"PageSize":[100]}}}}}},"/v2/email/account":{"get":{"tags":["Account"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetAccount.html","api_endpoint":"https://email.us-east-1.amazonaws.com/v2/email/account"},"summary":"Get Account Details","description":"Returns account details including sending status, quota, enforcement status, production access, and suppression attributes.","security":[{"bearerAuth":[]}]}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}