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

# Setup

> Step-by-step guide to connecting Gmail or Outlook to Prizm via OAuth so alert notifications can be sent by email.

<script type="application/ld+json">
  {`{
            "@context": "https://schema.org",
            "@type": "TechArticle",
            "headline": "Email Integration Setup",
            "description": "Step-by-step guide to connecting Gmail or Outlook to Prizm via OAuth so alert notifications can be sent by email.",
            "url": "https://docs.dqlabs.ai/integrations/email/setup",
            "publisher": {
              "@type": "Organization",
              "name": "DQLabs Inc",
              "logo": "https://media.brand.dev/332adc35-5bc4-4d2b-bf78-256aa4a5e414.svg"
            }
            }`}
</script>

## Connecting Email to Prizm

Prizm connects to Gmail and Outlook using OAuth — no SMTP passwords or app passwords are entered in Prizm. You authenticate directly on your provider's sign-in page and Prizm is granted a secure token to send alert emails on your behalf.

### Prerequisites

<Tabs>
  <Tab title="Gmail">
    * A Google account (personal Gmail or Google Workspace)
    * The account must be able to send email (Gmail not disabled by admin)

    <Note>
      For Google Workspace accounts, your admin may need to confirm that Gmail is enabled and that third-party OAuth access is permitted for your organization.
    </Note>
  </Tab>

  <Tab title="Outlook / Microsoft 365">
    * A Microsoft 365 or Outlook account to use as the sender
    * The account must be able to send email and allow third-party OAuth app access
  </Tab>
</Tabs>

### Connect Email in Prizm

<Steps>
  <Step title="Open Integration settings">
    Navigate to **Organization** → **Integration** and locate the **Email** tile. Click the pencil icon or **Connect** to open the configuration form.

    <Frame>
      <img src="https://mintcdn.com/dqlabs/oxRToOqPQtP_DU3V/images/image-61.png?fit=max&auto=format&n=oxRToOqPQtP_DU3V&q=85&s=28c2cf6f6399dcea694b4a9b7377e319" alt="Image" width="2482" height="878" data-path="images/image-61.png" />
    </Frame>
  </Step>

  <Step title="Select your email provider">
    In the **SMTP Server Type** dropdown, choose **Gmail** or **Outlook**.
  </Step>

  <Step title="Authenticate with your provider">
    Click **Connect**. You are redirected to your provider's sign-in page — Google for Gmail, or Microsoft for Outlook. Sign in with the account you want Prizm to send email from and grant the requested permissions. You are then redirected back to Prizm with the integration active.
  </Step>

  <Step title="Send a test notification">
    Click **Test Notification** to send a sample email from the connected account and confirm delivery. Check the inbox of the sender address to verify the email was sent successfully.
  </Step>

  <Step title="Save the configuration">
    Click **Update Integration**. The Email tile shows the connected account as active.

    <Frame>
      <img src="https://mintcdn.com/dqlabs/oxRToOqPQtP_DU3V/images/image-61.png?fit=max&auto=format&n=oxRToOqPQtP_DU3V&q=85&s=28c2cf6f6399dcea694b4a9b7377e319" alt="Image" width="2482" height="878" data-path="images/image-61.png" />
    </Frame>
  </Step>
</Steps>
