### List Your Mailboxes

Source: https://warmysender.com/docs/integrations

Example of making a GET request to the /mailboxes endpoint to retrieve a list of your configured mailboxes.

```curl
curl -X GET "https://warmysender.com/api/v1/mailboxes" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

--------------------------------

### Make Your First Request

Source: https://warmysender.com/docs/integrations

Example of making a GET request to the /me endpoint to verify your API key and authentication.

```curl
curl -X GET "https://warmysender.com/api/v1/me" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

--------------------------------

### Create a Mailbox

Source: https://warmysender.com/docs/integrations

Example of making a POST request to the /mailboxes endpoint to create a new mailbox. Ensure to replace placeholder values with your actual credentials and desired settings. The connection test runs asynchronously, and you can track its progress using the returned `job_id`.

```curl
curl -X POST "https://warmysender.com/api/v1/mailboxes" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: create-mailbox-123" \
  -d '{
    "email": "sales@yourcompany.com",
    "smtp_host": "smtp.gmail.com",
    "smtp_port": 587,
    "smtp_username": "sales@yourcompany.com",
    "smtp_password": "your-app-password",
    "imap_host": "imap.gmail.com",
    "imap_port": 993,
    "imap_username": "sales@yourcompany.com",
    "imap_password": "your-app-password",
    "auto_enable_warmup": true
  }'
```

--------------------------------

### Get Base URL

Source: https://warmysender.com/docs/integrations

The base URL for all WarmySender API requests.

```text
https://warmysender.com/api/v1
```

--------------------------------

### GET /mailboxes

Source: https://warmysender.com/docs/integrations

Lists all mailboxes associated with the authenticated account.

```APIDOC
## GET /mailboxes

### Description
Lists all mailboxes configured for the authenticated account.

### Method
GET

### Endpoint
https://warmysender.com/api/v1/mailboxes
```

--------------------------------

### GET /me

Source: https://warmysender.com/docs/integrations

Retrieves the current user's profile information.

```APIDOC
## GET /me

### Description
Retrieves the profile information for the authenticated user.

### Method
GET

### Endpoint
https://warmysender.com/api/v1/me
```

--------------------------------

### POST /mailboxes

Source: https://warmysender.com/docs/integrations

Creates a new mailbox configuration for email warmup.

```APIDOC
## POST /mailboxes

### Description
Creates a new mailbox. The connection test runs asynchronously, and a job_id is returned to track progress.

### Method
POST

### Endpoint
https://warmysender.com/api/v1/mailboxes

### Request Body
- **email** (string) - Required - The email address of the mailbox
- **smtp_host** (string) - Required - SMTP server host
- **smtp_port** (integer) - Required - SMTP server port
- **smtp_username** (string) - Required - SMTP username
- **smtp_password** (string) - Required - SMTP password
- **imap_host** (string) - Required - IMAP server host
- **imap_port** (integer) - Required - IMAP server port
- **imap_username** (string) - Required - IMAP username
- **imap_password** (string) - Required - IMAP password
- **auto_enable_warmup** (boolean) - Optional - Whether to enable warmup automatically

### Request Example
{
  "email": "sales@yourcompany.com",
  "smtp_host": "smtp.gmail.com",
  "smtp_port": 587,
  "smtp_username": "sales@yourcompany.com",
  "smtp_password": "your-app-password",
  "imap_host": "imap.gmail.com",
  "imap_port": 993,
  "imap_username": "sales@yourcompany.com",
  "imap_password": "your-app-password",
  "auto_enable_warmup": true
}
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.