Skip to main content
This feature is currently in preview and only available to select teams. Contact support if you’d like early access.

​
Overview

The Team API allows you to programmatically manage your Lettermint team resources including domains, projects, routes, webhooks, suppressions, messages, and team settings. Using Team API tokens with granular permissions, you can automate team operations and integrate Lettermint into your infrastructure.
Team API tokens are different from project API tokens. Project tokens (format: lm_xxx...) are used for sending emails, while Team tokens (format: lm_team_...) provide broader access to manage team resources via the API.
For information on creating and managing Team API tokens through the dashboard, see the Team API tokens guide.

​
Prerequisites

Before you start, ensure you have:
  • A Lettermint account with the team owner role
  • A Team API token with appropriate abilities (see Team API tokens)
  • Basic familiarity with REST APIs and JSON
  • cURL or an HTTP client installed

​
Authentication

Team API tokens authenticate requests to the Lettermint API using the Bearer authentication scheme. Each token has a unique format beginning with lm_team_ followed by 40 random characters. Include your token in the Authorization header of every request: 
curl -X GET "https://api.lettermint.co/v1/team" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer lm_team_your_token_here"
Team API token displayed once after creation in the dashboard
Never commit tokens to version control or expose them in client-side code. Store tokens securely in environment variables or a secrets manager.

​
Next Steps