> ## 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 Zoho Mail account

> Use an application-specific password to send from a Zoho mailbox.

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 Zoho mailbox so your agents can send from it. The wizard asks for an app password
(a separate code you create in your Zoho security settings) rather than the password you sign
in with.

<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

* You can sign in to this mailbox yourself. Create the app password while signed in to the
  exact mailbox you are connecting, not to another account you also own.
* Somewhere to paste the code the moment it appears. Most providers show an app password
  once and never again.
* If two-factor authentication is on for that Zoho account, the ordinary account password
  will not pass verification here. The app password is the only credential that works.

## Connect the mailbox

<Steps>
  <Step title="Open the provider list">
    Go to <UiPath>Integrations → Integrations → Email Accounts</UiPath> and choose
    **Add senders**. On the panel, choose **Connect your email**, whose button reads
    **Connect**.

    Gmail and Outlook lead as their own cards. Everything else sits in the **All providers**
    grid below them, in alphabetical order, which puts Zoho last. Choose it.

    <Screenshot id="email-accounts/connect-zoho--provider-picker" url="/senders" alt="The All providers grid in the Add senders panel, a tile per provider with Zoho among them" caption="Every tile below the divider runs the same wizard. Only the server values behind it change." />
  </Step>

  <Step title="Create an app password in Zoho">
    The wizard opens on **Get ready: create an app password**, which explains what one is: a
    separate code, generated in your Zoho security settings, that lets us send without ever
    knowing your real password. Create it there and copy it straight away.

    Back on the wizard, choose **I have my app password**.
  </Step>

  <Step title="Enter your account details">
    On the **Your account** screen, put the mailbox address in **Email address** and the name
    recipients should see in **Sender name**. The name on your own account is used there by
    default, so change it only if you want something else. Choose **Continue**.
  </Step>

  <Step title="Paste the app password and verify">
    Paste the code into **App password**. The helper under the field says the same thing: the
    app password you just created, not your regular Zoho password.

    Under the field, the wizard prints the sending server it is about to use: host, port and
    security type, next to an **Edit** link. **Edit** adds a **Server settings** step where
    you can change the sending and receiving servers by hand. Left alone, Zoho's own values
    are used: `smtp.zoho.com` for sending and `imap.zoho.com` for reading replies, both over
    SSL.

    Choose **Verify connection**. We open a real connection to Zoho for both sending and
    receiving, because a mailbox that can send but not receive would never see a reply.
  </Step>
</Steps>

## What happens next

<Check>
  A confirmation panel reads "Your email is connected" with the mailbox address under it.
  Choose **Done**, and the mailbox is on the Email Accounts page.
</Check>

An account connected through this wizard arrives with no sending schedule, and its row shows
**No Schedule** rather than **Active**. That chip is not a warning you can ignore: a send only
goes out when the current day and time fall inside one of the account's sending hours, so
until you set them, nothing sends. The chip is a link: it opens that account's schedule
section. [Sender settings](/en/email-accounts/sender-settings) covers the fields there.

Once the schedule exists, the row shows **No Campaigns** until a campaign is attached to the
account, and **Active** after that.

A brand-new mailbox does not send at full volume even then. 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.

The server values the Zoho tile filled in are not hidden from you afterwards. Open the account
from Email Accounts and its first section holds the same fields, with the SMTP and IMAP boxes
behind an Advanced settings toggle.

<Screenshot id="email-accounts/connect-zoho--form" url="/senders/new/zoho" frame="bare" alt="A new Zoho email account form with the name and address fields still blank, the SMTP and IMAP fields for smtp.zoho.com and imap.zoho.com filled in and expanded, and the app password field empty" caption="The same preset values, shown as separate fields. You are not expected to know them." />

## Troubleshooting

<AccordionGroup>
  <Accordion title="That password didn't work">
    Zoho rejected this address and password together, so check both. Choose
    **Re-enter password** to go back to the field. Nothing you typed is lost.

    A partly copied app password fails exactly like a wrong one, and so does one created
    while signed in to a different account. If you are unsure which you pasted, generate a
    fresh app password in Zoho and use that.
  </Accordion>

  <Accordion title="We couldn't read this inbox (IMAP)">
    Sending only works when we can also read replies, and IMAP access looks turned off for
    this mailbox. The screen walks you through it: open your Zoho mailbox settings, find the
    IMAP section (sometimes labelled "external access") and turn it on, then come back and
    choose **Try again**.
  </Accordion>

  <Accordion title="The mailbox connected, but nothing is sending">
    A connected mailbox is not the same as a sending one. Check the schedule first, since an
    account connected this way starts without one. After that the usual causes are an agent
    whose outreach is still paused and a new mailbox whose daily limit is still zero. Work
    through [No sending channel connected](/en/troubleshooting/agent-not-sending), which goes
    over them in the order worth checking.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Add senders" icon="plus" href="/en/email-accounts/add-senders">
    Connect, import a CSV, or order managed infrastructure: how to choose between them.
  </Card>

  <Card title="Sender settings" icon="sliders-horizontal" href="/en/email-accounts/sender-settings">
    Every field in the email account form, including the schedule and the ones Zoho filled in.
  </Card>

  <Card title="Email account statuses" icon="activity" href="/en/email-accounts/sender-statuses">
    What Active, Paused and Error mean, and the chips that aren't a status at all.
  </Card>

  <Card title="Reconnect an account" icon="refresh-cw" href="/en/email-accounts/reconnect-a-sender">
    What Reconnect actually does, and every Error message explained.
  </Card>
</CardGroup>
