cognito-import v1.2.12

Cognito Import

A simple CLI tool and JavaScript package for importing users into an AWS Cognito user pool.

This tool works perfectly with cognito-export. The user records exported match the import template to easily export from one user pool and import to another.

Getting Started

1. Use it as a CLI tool to import users from a CSV file into a user pool

npx cognito-import -u <user-pool-id> -f ./users.csv -v

2. or, use it in Node.js

npm i cognito-import

import cognitoImport from "cognito-import";

await cognitoImport(users, {
  userPoolId: "<user-pool-id>",
});

All flags and options can be found in the table below.

1. CLI Options

A full example of the CLI tool in effect can be found below:

npx cognito-import -u eu-west-1_aaaaaaaaa -p SOMEPROFILE -v -f ./users.csv

## 2. Node.js Example

A full example of the package in effect can be found below:

import cognitoImport, { ImportUsers } from "cognito-import";

const users: ImportUsers = []; // Get your users ready

await cognitoImport(users, {
  userPoolId: "eu-west-1_aaaaaaaaa",
  profile: "SOMEPROFILE",
});

Please note: This method supports all flags documented above, except the file and verbose flags. Instead, the method expects the users to be passed in.

Use with cognito-export

npx cognito-export -u eu-west-1_aaaaaaaaa -p PROFILE_A &&
npx cognito-import -u eu-west-1_bbbbbbbbb -p PROFILE_B -f users.csv

or

import cognitoExport from "cognito-export";
import cognitoImport from "cognito-import";

const users = await cognitoExport({
  userPoolId: "eu-west-1_aaaaaaaaa",
  profile: "PROFILE_A",
});

const job = await cognitoImport(users, {
  userPoolId: "eu-west-2_bbbbbbbbb",
  profile: "PROFILE_B",
});