Skip to content

Commit 3830130

Browse files
docs: Add mailbox connection docs
1 parent debabf6 commit 3830130

File tree

1 file changed

+28
-54
lines changed

1 file changed

+28
-54
lines changed

mailboxes/connect.mdx

+28-54
Original file line numberDiff line numberDiff line change
@@ -3,57 +3,31 @@ title: Connect mailboxes
33
description: FirstQuadrant will automatically provision domains and email accounts as you start and scale your campaigns. However, if you prefer to use your own domain and email accounts, you can connect them to FirstQuadrant.
44
---
55

6-
## Connect a mailbox
7-
8-
Visit Settings -> Mailboxes and click on **Create mailbox** to connect a mailbox to your FirstQuadrant team. Enter the required information and click "Connect mailbox". For example, to add the email address `[email protected]`:
9-
10-
1. Local: The local part of the email address, e.g. `jane`
11-
1. Domain: Select the domain part of the email address, e.g. `example.com`
12-
1. Team member: Select the team member who will be using this mailbox
13-
1. Provider: Select the email provider, e.g. Google Workspace
14-
1. You will be redirected to your email provider to authorize FirstQuadrant to access your mailbox
15-
16-
After adding a mailbox, click on "Set up warming"; this is a critical step to ensure your emails are delivered to the inbox. Follow the instructions below to set up email warming.
17-
18-
## App passwords
19-
20-
To set up [Email warming](/mailboxes/email-warming), FirstQuadrant requires access to your email accounts. We recommend creating app passwords for each email account you want to use with FirstQuadrant. This will allow you to revoke access to FirstQuadrant without changing your email account password.
21-
22-
### Turn on 2-step verification
23-
24-
To create app passwords, you must first turn on 2-step verification for your Google account. This is a security feature that requires you to verify your identity using a second method, such as your phone or a security key, when signing in to your account:
25-
26-
1. Log in to and open your [Google Account](https://myaccount.google.com)
27-
1. In the navigation panel, select **Security**
28-
1. Under "Signing in to Google," select 2-Step Verification and then **Get started**
29-
1. Follow the on-screen steps
30-
31-
For more information, see [Turn on 2-Step Verification](https://support.google.com/accounts/answer/185839) on Google's support documentation.
32-
33-
### Create an app password
34-
35-
1. On the FirstQuadrant "Mailboxes" settings page, click on **Set up warming**
36-
1. In a different tab, go to your Google Account
37-
1. Select **Security**
38-
1. Under "Signing in to Google," select **App Passwords**; if you can't find it, you can use the search bar
39-
1. At the bottom, choose **Select app** and choose "Mail" and then Select device and enter "FirstQuadrant", then click **Generate**
40-
1. The App Password is the 16-character code in the yellow bar on your device, enter this code in FirstQuadrant
41-
42-
For more information, see [Sign in using App Passwords](https://support.google.com/accounts/answer/185833) on Google's support documentation.
43-
44-
<Warning>
45-
Google automatically revokes your app passwords when you change your Google
46-
Account password; make sure to update your app passwords when you change your
47-
Google Account password.
48-
</Warning>
49-
50-
### Turn on IMAP access
51-
52-
For email warming to correctly work, FirstQuadrant requires access to your mailbox using IMAP (Internet Message Access Protocol), but this is disabled by default in Gmail, so you may have to activate it:
53-
54-
1. Open Gmail and in the top right, click on "Settings" and then **See all settings**
55-
1. Click the "Forwarding and POP/IMAP" tab
56-
1. In the "IMAP access" section, select **Enable IMAP**
57-
1. Click Save Changes
58-
59-
For more information, see [Check Gmail through other email platforms](https://support.google.com/mail/answer/7126229) on Google's support documentation.
6+
## Google Workspace
7+
8+
If you're using Google Workspace (Gmail), you will first have to enable the FirstQuadrant app for your account:
9+
10+
1. Log in to your Google Workspace admin console.
11+
2. Go to Security > Access and data control -> API controls.
12+
3. Click on "Manage third party app access" on the right.
13+
4. Click on "Add app" and select the first option, "OAuth app name or Client ID".
14+
5. Enter the following Client ID: `470411331886-vf3vhsd4rr1oje0i6ogvmc5rr71hngnn.apps.googleusercontent.com`.
15+
6. Select the FirstQuadrant app and click on "Select".
16+
7. Continue by checking the box and then selecting "Trusted" in the next step.
17+
8. Finish the set up flow, and you're done!
18+
19+
## Adding mailboxes
20+
21+
Visit Settings -> Mailboxes and click on "Connect mailbox" to add a new mailbox. YOu can select from Google, Outlook, Exchange, Zoho, IMAP, or "More" if your provider is not listed.
22+
23+
You can also import mailboxes from a CSV file. Click on "Select file" and upload a CSV file with the following columns:
24+
25+
- Email
26+
- IMAP Host
27+
- IMAP Port
28+
- IMAP Username
29+
- IMAP Password
30+
- SMTP Host
31+
- SMTP Port
32+
- SMTP Username
33+
- SMTP Password

0 commit comments

Comments
 (0)