---
title: "Manage your account with the new Team API"
description: "Manage your entire Lettermint environment via the API. The Team API is now in preview and offers full control over domains, projects, emails and more."
url: "https://lettermint.co/changelog/team-api-now-in-preview-manage-your-account-via-api"
published: "2025-10-29"
last_updated: "2025-10-29"
---

# Manage your account with the new Team API

> Manage your entire Lettermint environment via the API. The Team API is now in preview and offers full control over domains, projects, emails and more.

Until now, our [API](https://docs.lettermint.co/api-reference/send/send-an-email)
was primarily focused on sending emails via the `/send` endpoint. Starting
today, we're expanding this with the **Team API**, which allows you to
manage your entire Lettermint environment via the API.

With the Team API, you get access to all the functionality you know from
the dashboard, but directly from your application. You can add and configure
[domains](https://lettermint.co/features/multiple-domains), create projects, and
retrieve email statistics. Useful when you want to integrate Lettermint into
your existing systems or automate workflows.

The Team API supports:

- Adding and managing domains
- Creating and managing projects
- Retrieving and filtering emails
- Setting up and managing webhooks
- Managing suppression lists
- Managing team

## How does the Team API work?

The Team API uses team API tokens that you can create in your team settings.
You have the option to set automatic token expiration, assign specific
permissions to tokens, and view an activity log to see what your token does.

An example of retrieving emails within your team:

```bash
curl --request GET \
  --url https://api.lettermint.co/v1/messages \
  --header 'Authorization: Bearer xxxxx'
```

You'll receive an overview of all your emails including status, recipients,
and other information. Below is an example of the JSON you'll receive:

```jsonsimple
{
  "data": [
    {
      "id": "e9ed2ecb",
      "type": "outbound",
      "status": "delivered",
      "from_email": "noreply@example.com",
      "from_name": "Lettermint",
      "subject": "Welcome to Lettermint",
      "to": [
        {
          "email": "user@example.com",
          "name": "John Doe"
        }
      ],
      "cc": [],
      "bcc": [],
      "reply_to": [],
      "tag": "onboarding",
      "created_at": "2025-10-29T10:30:00Z"
    }
  ],
  "path": "/v1/messages",
  "per_page": 30,
  "next_cursor": "eyJp...",
  "next_page_url": "/v1/messages?cursor=eyJp...",
  "prev_cursor": null,
  "prev_page_url": null
}
```

## Access to the Team API

The Team API is currently available in preview and will be fully available
to all customers soon. Want access now? Submit a support ticket via your
dashboard, and we'll activate the Team API for your account.

For more information about all available endpoints and possibilities, check
our [API documentation](https://docs.lettermint.co/api-reference/).
