> ## Documentation Index
> Fetch the complete documentation index at: https://help.pipelime.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect a Gmail or Google Workspace account

> Send from a Gmail or Google Workspace mailbox using an app password, in about two minutes.

export const UiPath = ({children}) => {
  const parts = String(children).split(/\s*(?:→|>)\s*/).filter(Boolean);
  return <span className="pl-path">
      {parts.map((part, index) => <span key={`${index}-${part}`}>
          {index > 0 && <span className="pl-path__sep">→</span>}
          {part}
        </span>)}
    </span>;
};

export const Screenshot = ({id, alt, caption, frame = 'browser', url, marks = [], lang = 'en', workspace = 'northwind-outbound'}) => {
  const src = `/images/screenshots/${lang}/${id}.png`;
  const chrome = url ? `app.pipelime.ai/${workspace}${url}` : 'app.pipelime.ai';
  return <figure className={`pl-shot pl-shot--${frame} not-prose`}>
      <div className="pl-shot__frame">
        {frame !== 'bare' && <div className="pl-shot__bar">
            <span className="pl-shot__dots">
              <span className="pl-shot__dot" />
              <span className="pl-shot__dot" />
              <span className="pl-shot__dot" />
            </span>
            <span className="pl-shot__url">{chrome}</span>
          </div>}
        <div className="pl-shot__media">
          <img src={src} alt={alt} loading="lazy" />
          {marks.map(mark => <span key={mark.n} className="pl-shot__mark" style={{
    left: `${mark.x}%`,
    top: `${mark.y}%`
  }} aria-hidden="true">
              {mark.n}
            </span>)}
        </div>
      </div>
      {caption && <figcaption className="pl-shot__caption">{caption}</figcaption>}
    </figure>;
};

Connect a Gmail or Google Workspace mailbox so your agents can send from it. Google
does not accept your normal password for this, so you create an app password
instead: a code that only works for sending mail and that you can revoke at any
time without changing your Google password.

<div className="pl-availability">
  <div className="pl-availability__row">
    <div className="pl-availability__label">Where</div>
    <div className="pl-availability__value"><span className="pl-path">Integrations<span className="pl-path__sep">→</span>Integrations<span className="pl-path__sep">→</span>Email Accounts</span></div>
  </div>

  <div className="pl-availability__row">
    <div className="pl-availability__label">Your role needs</div>
    <div className="pl-availability__value">Read access to Email Accounts <code>read-senders</code>. Admin, Member and Viewer have it by default.</div>
  </div>

  <div className="pl-availability__row">
    <div className="pl-availability__label">To create or change</div>
    <div className="pl-availability__value"><code>create-senders</code> to add one, <code>update-senders</code> to change one, on top of the permission above.</div>
  </div>

  <div className="pl-availability__note">If you cannot find this in your sidebar, your workspace may have a custom menu configuration. Contact support and we will check it for you.</div>
</div>

## Before you begin

* The mailbox has to be one you can sign into, because you create the app
  password inside Google's own settings.
* 2-Step Verification must be on for that Google account. Google only offers app
  passwords once it is.
* On Google Workspace, an administrator can switch app passwords off for the
  whole organisation. If the app passwords page shows an error rather than a
  form, that is why, and only an administrator can change it.

<Note>
  Warm-up is not available for Gmail or Google Workspace mailboxes. Google's terms
  do not allow it, so a Google mailbox builds its reputation through your real
  sending instead. See [Google warm-up policy](/en/email-accounts/google-warmup-policy).
</Note>

## Connect the mailbox

<Steps>
  <Step title="Open the provider list">
    Go to <UiPath>Integrations → Integrations → Email Accounts</UiPath> and choose
    **Add Sender**, then **Connect**.

    Gmail and Outlook are shown first (1); everything else is in the grid below.
    Choose **Gmail**.

    <Screenshot id="email-accounts/connect-gmail--provider-picker" url="/senders?senders=connect" alt="The provider list, with Gmail and Outlook shown as the two featured cards above a grid of other providers" caption="Choosing a provider fills in the technical settings for you, so there is nothing to look up." marks={[{ n: 1, x: 26, y: 34 }]} />
  </Step>

  <Step title="Turn on 2-Step Verification">
    The first step of the wizard links straight to your Google security settings.
    Open it, and check the avatar in the top-right corner before you do anything
    else. Signing in with the wrong Google account is the most common way this
    goes wrong.

    If 2-Step Verification is off, turn it on and follow Google's prompts, then
    come back and choose **It's on — next step**.
  </Step>

  <Step title="Create an app password">
    The second step opens Google's app passwords page. Give the password any name
    you like and press Create. Google then shows a 16-character code in four
    groups, once.

    Copy it now. Google will not show it again, and it is not your Google
    password. It is a code that only lets us send mail.

    <Screenshot id="email-accounts/connect-gmail--app-password-step" url="/senders?senders=connect" alt="The wizard step that explains where to find Google's app passwords page and what the generated code looks like" caption="Spaces in the code do not matter. Paste it exactly as Google shows it." />
  </Step>

  <Step title="Enter your details">
    Back in PipeLime, fill in the mailbox address, paste the app password, and
    give the sender the name you want recipients to see in their inbox.

    You do not need to touch the server settings: choosing Gmail already set
    them.
  </Step>

  <Step title="Verify the connection">
    Choose **Verify connection**. We open a real connection to Google for both
    sending and receiving, because a mailbox that can send but not receive would
    never see a reply.

    <Screenshot id="email-accounts/connect-gmail--verified" url="/senders?senders=connect" alt="A confirmation panel with a green tick reading 'Your email is connected', the mailbox address beneath it, and buttons to finish or add another sender" caption="Verification uses the credentials you entered, so reaching this screen means the mailbox really can send and receive." />
  </Step>
</Steps>

## What happens next

<Check>
  The mailbox appears on the Email Accounts page as **Active**, and your agents
  can send from it.
</Check>

A brand-new mailbox does not start sending campaigns at full volume, and for its
first weeks it may send none at all. That is deliberate: sending too much too
early from a fresh mailbox is what gets addresses filtered. See
[Smart Daily Limit](/en/email-accounts/smart-daily-limit) for how the daily number
is worked out, and
[The quarantine and ramp-up for new mailboxes](/en/email-accounts/quarantine-and-ramp-up)
for what to expect in the first month.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Google says the app passwords page is not available">
    Either 2-Step Verification is not on for this account yet, or you are signed
    into a different Google account than you think. On Google Workspace, an
    administrator may have disabled app passwords for everyone. Ask them, because
    it cannot be changed from your side.
  </Accordion>

  <Accordion title="Verification fails with an authentication error">
    Almost always the app password rather than the address. Generate a new one and
    paste it again: an app password is shown once, and a partly-copied code fails
    exactly like a wrong one.

    Check too that the address you entered is the same account you created the
    app password under.
  </Accordion>

  <Accordion title="The mailbox connected, but nothing is sending">
    A connected mailbox is not the same as a sending one. The most common reasons
    are that the agent's outreach is still paused, or that the mailbox is new and
    still warming up. Work through
    [My agent isn't sending anything](/en/troubleshooting/agent-not-sending),
    which goes over the reasons in the order worth checking.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Add senders" icon="plus" href="/en/email-accounts/add-senders">
    The three ways to add mailboxes, including managed infrastructure.
  </Card>

  <Card title="Email account statuses" icon="activity" href="/en/email-accounts/sender-statuses">
    What Active, Paused and Error mean, and how to clear an error.
  </Card>

  <Card title="Google warm-up policy" icon="shield" href="/en/email-accounts/google-warmup-policy">
    Why Google mailboxes cannot join the warm-up network.
  </Card>

  <Card title="Smart Daily Limit" icon="gauge" href="/en/email-accounts/smart-daily-limit">
    How your daily sending number is calculated, and why it moves.
  </Card>
</CardGroup>