---
id: aws-cdk-aws-cognito
version: "1.204.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aws-cdk.aws-cognito — The CDK Construct Library for AWS::Cognito

License: permissive · Maintenance: active · Downloads: 150.4K/mo

## What it is and what it does

This package provides a Python construct library for AWS CDK v1 that lets you define Amazon Cognito user pools and related authentication infrastructure declaratively. It wraps CloudFormation resources and higher-level abstractions for common Cognito patterns like sign-up, sign-in with multiple aliases (username, email, phone), multi-factor authentication, Lambda triggers, and identity providers.

The library is stable for CloudFormation resources and user pool constructs, but Identity Pool L2 constructs are not implemented here. Critically, AWS CDK v1 reached end-of-support on 2023-06-01 and is no longer maintained; AWS recommends migrating to CDK v2 for new projects and ongoing support.

Use it for:

- Define a user pool with self-sign-up and email verification in a CDK stack without writing CloudFormation directly.
- Configure sign-in options (username, email, phone) and multi-factor authentication for a web or mobile app.
- Set up Lambda triggers for custom authentication flows or user lifecycle events in Cognito.
- Grant IAM roles permissions to perform Cognito operations like admin user creation.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides AWS CDK constructs for defining Amazon Cognito user pools and identity management infrastructure as code in Python.

No, unless you are maintaining an existing CDK v1 project. AWS CDK v1 is end-of-support since 2023-06-01 and receives no updates. New projects should use aws-cdk.aws-cognito from AWS CDK v2 instead, which is actively maintained and has a migration guide available.

## Install

pip install aws-cdk-aws-cognito
uv add aws-cdk-aws-cognito
poetry add aws-cdk-aws-cognito

## Installing aws-cdk.aws-cognito

Before you install: Low install friction with a wheel distribution. However, this is AWS CDK v1, which reached end-of-support on 2023-06-01 and is no longer being updated; users should migrate to AWS CDK v2 instead.

License in practice: Licensed under Apache-2.0 (permissive), allowing use in commercial and private projects with minimal restrictions.

Quickstart:

pip install aws-cdk.aws-cognito

from aws_cdk import aws_cognito as cognito

user_pool = cognito.UserPool(self, "myuserpool",
    user_pool_name="myawesomeapp-userpool"
)

AWS CDK v1 is end-of-support as of 2023-06-01; new projects should use AWS CDK v2 instead.

Verify before relying:

- Whether Identity Pool L2 constructs are available in this v1 package or only in the v2 alpha module.
- Current adoption and migration timeline for projects still on CDK v1.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 150.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

cognito user pool cdk, aws authentication infrastructure as code, cognito construct library, cdk user management, aws identity pool cdk, cognito sign-in configuration, cdk authentication setup, infrastructure-as-code, aws-cdk, end-of-life

[View on SkillFed](https://skillfed.io/packages/aws-cdk-aws-cognito) · [View on PyPI](https://pypi.org/project/aws-cdk-aws-cognito/)