Copy page

Team API

Quickstart

Now that you understand authentication, let's make your first API requests to get familiar with the Team API.

Get Team Details

Retrieve information about your team including name, plan, tier, and verification status.

Response:

Code
{
  "id": "9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d",
  "name": "Acme Corp",
  "plan": "starter",
  "tier": "10000",
  "verified_at": "2024-01-15T10:30:00.000Z",
  "created_at": "2024-01-01T00:00:00.000Z"
}

List Your Domains

Retrieve all verified domains in your team. This endpoint supports cursor-based pagination.

Response:

Code
{
  "data": [
    {
      "id": "1a2b3c4d",
      "domain": "example.com",
      "verified_at": "2024-01-15T10:30:00.000Z",
      "created_at": "2024-01-10T00:00:00.000Z"
    }
  ],
  "next_cursor": "eyJpZCI6MTUsIl9wb2ludHNUb05leHRJdGVtcyI6dHJ1ZX0",
  "next_page_url": "https://api.lettermint.co/v1/domains?page[cursor]=eyJpZCI...",
  "per_page": 30
}

Create a New Project

Create a new project within your team. Projects are used to organize your email sending and contain routes.

Success Response (201):

Code
{
  "data": {
    "id": "5f4e3d2c",
    "name": "Production App",
    "smtp_enabled": false,
    "created_at": "2024-01-20T15:45:00.000Z"
  },
  "message": "Project created successfully."
}

Validation Error (422):

Code
{
  "message": "The name field is required.",
  "errors": {
    "name": ["The name field is required."]
  }
}

Next Steps

• Reference - Learn about abilities, rate limits, and error handling
• Use Cases & Best Practices - Explore common workflows and production guidance
• API Reference - View complete API documentation