SES module

Index > SES

Auto-generated documentation for SES type annotations stubs module mypy-boto3-ses.

How to install

Generate locally (recommended)

You can generate type annotations for boto3 package locally with mypy_boto3_builder. Use uv for build isolation.

1. Run mypy-boto3-builder in your package root directory: uvx --with 'boto3==1.35.99' mypy_boto3_builder
2. Select boto3-stubs AWS SDK.
3. Add SES service.
4. Use provided commands to install generated packages.

VSCode extension

Add AWS Boto3 extension to your VSCode and run AWS boto3: Quick Start command.

Click Modify and select boto3 common and SES.

From PyPI with pip

Install boto3-stubs for SES service.

# install with boto3 type annotations
python -m pip install 'boto3-stubs[ses]'

# Lite version does not provide session.client/resource overloads
# it is more RAM-friendly, but requires explicit type annotations
python -m pip install 'boto3-stubs-lite[ses]'

# standalone installation
python -m pip install mypy-boto3-ses

How to uninstall

python -m pip uninstall -y mypy-boto3-ses

Usage

Code samples can be found in Examples.

SESClient

Type annotations and code completion for boto3.client("ses") as SESClient boto3 documentation

# SESClient usage example

from boto3.session import Session

from mypy_boto3_ses.client import SESClient

def get_client() -> SESClient:
    return Session().client("ses")

Paginators

Type annotations and code completion for paginators from boto3.client("ses").get_paginator("...").

# ListConfigurationSetsPaginator usage example

from boto3.session import Session

from mypy_boto3_ses.paginator import ListConfigurationSetsPaginator

def get_list_configuration_sets_paginator() -> ListConfigurationSetsPaginator:
    return Session().client("ses").get_paginator("list_configuration_sets"))

• ListConfigurationSetsPaginator
• ListCustomVerificationEmailTemplatesPaginator
• ListIdentitiesPaginator
• ListReceiptRuleSetsPaginator
• ListTemplatesPaginator

Waiters

Type annotations and code completion for waiters from boto3.client("ses").get_waiter("...").

# IdentityExistsWaiter usage example

from boto3.session import Session

from mypy_boto3_ses.waiter import IdentityExistsWaiter

def get_identity_exists_waiter() -> IdentityExistsWaiter:
    return Session().client("ses").get_waiter("identity_exists")

• IdentityExistsWaiter

Literals

Type annotations for literals used in methods and schema.

# BehaviorOnMXFailureType usage example

from mypy_boto3_ses.literals import BehaviorOnMXFailureType

def get_value() -> BehaviorOnMXFailureType:
    return "RejectMessage"

• BehaviorOn