Skip to main content
The AWS SDK for JavaScript v3 is a complete rewrite of v2, designed around modularity and developer experience. Install only the packages you need, enjoy first-class TypeScript support, and use a powerful middleware stack to customize every request.

Quick Start

Make your first AWS API call in under 5 minutes.

Installation

Install service clients, credential providers, and utilities.

Core Concepts

Understand clients, commands, middleware, and paginators.

API Reference

Explore the full API for S3, DynamoDB, Lambda, and more.

​
Get started

1

Install a service client

Each AWS service has its own package. Install only what you need.
npm install @aws-sdk/client-s3
2

Create a client and send a command

Instantiate a client with your AWS region, then send a typed command.
import { S3Client, ListBucketsCommand } from "@aws-sdk/client-s3";

const client = new S3Client({ region: "us-east-1" });
const response = await client.send(new ListBucketsCommand({}));
console.log(response.Buckets);
3

Configure credentials

The SDK automatically resolves credentials from environment variables, ~/.aws/credentials, IAM roles, and more.
export AWS_ACCESS_KEY_ID=your-access-key
export AWS_SECRET_ACCESS_KEY=your-secret-key
export AWS_REGION=us-east-1

​
Why v3?

Modular packages

One npm package per AWS service. Your bundle only includes what you import.

TypeScript native

Every client, command, and input/output shape is fully typed.

Middleware stack

Intercept and modify requests and responses at any lifecycle step.

Async paginators

Use for await...of loops over paginated results without manual token handling.

Cross-platform

Works in Node.js, browsers, and React Native with platform-appropriate defaults.

Higher-level libraries

lib-dynamodb and lib-storage simplify common patterns like marshalling and multipart uploads.

​
Explore by topic

Authentication

Learn how to provide credentials using environment variables, shared config files, SSO, IAM roles, and more.

Error handling

Catch and inspect typed service errors and unmodeled exceptions.

DynamoDB Document Client

Work with native JavaScript types instead of DynamoDB AttributeValue shapes.

S3 Multipart Upload

Upload large files and streams reliably with automatic multipart handling.

Middleware

Add logging, retries, tracing, or custom headers to any client.

Migrating from v2

A practical guide for upgrading from aws-sdk v2 to v3.

Build docs developers (and LLMs) love

Get started for freeTalk to us