Post confirmation Lambda trigger
Amazon Cognito invokes this trigger after a new user is confirmed, allowing you to send custom messages or to add custom logic. For example, you could use this trigger to gather new user data.
The request contains the current attributes for the confirmed user.
Topics
Post confirmation Lambda flows
Client confirm sign-up flow

Server confirm sign-up flow

Confirm forgot password flow

Post confirmation Lambda trigger parameters
These are the parameters that Amazon Cognito passes to this Lambda function along with the event information in the common parameters.
Post confirmation request parameters
- userAttributes
-
One or more key-value pairs representing user attributes.
- clientMetadata
-
One or more key-value pairs that you can provide as custom input to the Lambda function that you specify for the post confirmation trigger. You can pass this data to your Lambda function by using the ClientMetadata parameter in the following API actions: AdminConfirmSignUp, ConfirmForgotPassword, ConfirmSignUp, and SignUp.
Post confirmation response parameters
No additional return information is expected in the response.
User confirmation tutorials
The post confirmation Lambda function is triggered just after Amazon Cognito confirms a new user. See these user confirmation tutorials for JavaScript, Android, and iOS.
Platform | Tutorial |
---|---|
JavaScript Identity SDK | Confirm users with JavaScript |
Android Identity SDK | Confirm users with Android |
iOS Identity SDK | Confirm users with iOS |
Post confirmation example
This example Lambda function sends a confirmation email message to your user using Amazon SES. For more information see Amazon Simple Email Service Developer Guide.
Amazon Cognito passes event information to your Lambda function. The function then returns the same event object to Amazon Cognito, with any changes in the response. In the Lambda console, you can set up a test event with data that is relevant to your Lambda trigger. The following is a test event for this code sample: