# Connect Gmail

Two ways to connect Gmail to Constanta Boost: OAuth (recommended) and App Password.

***

## Option 1: Google OAuth (recommended)

OAuth is the most secure and convenient connection method.

### Step 1. Open Add Mailbox Modal

1. On dashboard, click **"Add Mailbox"** button
2. Modal window opens with connection options

### Step 2. Select Google OAuth

1. Click on **"Google"** card
2. Google authorization window opens

### Step 3. Authorize with Google

1. Select account or sign in
2. Click **"Continue"** to confirm permissions
3. Done! Mailbox appears in the list

### Required Permissions

Constanta Boost requests:

| Permission    | Purpose                   |
| ------------- | ------------------------- |
| Read mail     | Receive emails from seeds |
| Send mail     | Send warmup emails        |
| Manage labels | Move emails from spam     |

{% hint style="info" %}
Tokens are stored encrypted and automatically refreshed.
{% endhint %}

***

## Option 2: App Password

Use this method if OAuth is unavailable.

### Step 1. Enable 2FA in Google

1. Go to [Google Security](https://myaccount.google.com/security)
2. Find **"2-Step Verification"**
3. Enable and configure

### Step 2. Create App Password

1. Go to [App Passwords](https://myaccount.google.com/apppasswords)
2. Select app: **"Mail"**
3. Select device: **"Other"** → enter "Constanta Boost"
4. Click **"Generate"**
5. Copy the 16-character password

{% hint style="warning" %}
Save the password! Google shows it only once.
{% endhint %}

### Step 3. Connect in Constanta Boost

1. Click **"Add Mailbox"**
2. Select **"Gmail App Password"**
3. Enter:
   * **Email:** your Gmail address
   * **App Password:** 16-character password (no spaces)
4. Click **"Connect"**

### Result

After successful connection, mailbox appears with **Active** status:

***

## IMAP/SMTP Settings (automatic)

When connecting Gmail, the system automatically uses:

| Parameter   | Value          |
| ----------- | -------------- |
| IMAP server | imap.gmail.com |
| IMAP port   | 993 (SSL)      |
| SMTP server | smtp.gmail.com |
| SMTP port   | 587 (TLS)      |

***

## Troubleshooting

### "App access blocked"

Google may block sign-in. Solution:

1. Verify 2FA is enabled
2. Use App Password, not regular password
3. Try OAuth instead of App Password

### "Invalid password"

1. Make sure you're using App Password, not regular password
2. Enter password without spaces
3. Create a new App Password

### Emails not sending

1. Check Gmail daily limit (500 emails for free accounts)
2. Check if account is blocked
3. Wait 24 hours and try again

***

## Gmail Limits

| Account Type     | Sending Limit   |
| ---------------- | --------------- |
| Free Gmail       | 500 emails/day  |
| Google Workspace | 2000 emails/day |

{% hint style="info" %}
Constanta Boost automatically respects these limits.
{% endhint %}