> ## Documentation Index
> Fetch the complete documentation index at: https://loops.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# JavaScript SDK
> The official Loops SDK for JavaScript, with full TypeScript support.
[](https://www.npmjs.com/package/loops)
## Installation
Install the package [from npm](https://www.npmjs.com/package/loops):
```bash theme={"dark"}
npm install loops
```
You can install [Loops skills](/skills) to help your coding agents use the Loops CLI, API and SDKs to create campaigns, manage contacts, send events, and send transactional emails.
Minimum Node version required: 18.0.0.
You will need a Loops API key to use the SDK.
In your Loops account, go to the [API Settings page](https://app.loops.so/settings?page=api) and click **Generate key**.
Copy this key and save it in your application code (for example as `LOOPS_API_KEY` in an `.env` file).
}
href="/sdks/javascript/nextjs"
>
Read our guide for sending email from Next.js projects.
## Usage
```javascript theme={"dark"}
import { LoopsClient, APIError } from "loops";
const loops = new LoopsClient(process.env.LOOPS_API_KEY);
try {
const resp = await loops.createContact("test@example.com");
// resp.success and resp.id available when successful
} catch (error) {
if (error instanceof APIError) {
console.log(error.json);
console.log(error.statusCode);
}
}
```
Import `RateLimitExceededError` to handle rate limits. See the [SDK docs](hhttps://www.npmjs.com/package/loops) for every method, TypeScript types, rate limiting, and error handling.
See the API documentation to learn more about [rate limiting](/api-reference/intro#rate-limiting) and [error handling](/api-reference/intro#debugging).
View the full documentation on npm.
View the source code and release notes.
Read the Loops API reference.