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

# How to send emails from Auth0 with SMTP

> Configure Auth0 to send authentication emails through AutoSend SMTP.

export const APP_PATHS = {
  home: '/',
  quickstart: '/quickstart',
  domainConfiguration: '/domain',
  apiReference: '/api-reference',
  sendEmail: '/api-reference/mails/send',
  bulkSendEmail: '/api-reference/mails/bulk',
  upsertContactApiRef: '/api-reference/contacts/upsert-contact',
  transactional: '/transactional-emails',
  emailActivity: '/transactional-emails/email-activity',
  emailTemplates: '/transactional-emails/email-templates',
  sendingEmail: '/quickstart/email-using-api',
  transactionalTroubleshooting: '/transactional-emails/troubleshooting',
  marketing: '/marketing-emails',
  campaigns: '/marketing-emails/campaigns',
  contacts: '/marketing-emails/contacts',
  contactsIntroduction: '/marketing-emails/contacts/introduction',
  contactsImportCsv: '/marketing-emails/contacts/import-csv',
  contactsLists: '/marketing-emails/contacts/lists',
  contactsSegments: '/marketing-emails/contacts/segments',
  contactsCustomFields: '/marketing-emails/contacts/contact-properties',
  contactsContactProperties: '/marketing-emails/contacts/contact-properties',
  createContactPropertyApiRef: '/api-reference/contact-properties/create',
  listContactPropertiesApiRef: '/api-reference/contact-properties/list',
  getContactPropertyApiRef: '/api-reference/contact-properties/get-by-name',
  deleteContactPropertyApiRef: '/api-reference/contact-properties/delete',
  sender: '/marketing-emails/sender',
  unsubscribeGroups: '/others/unsubscribe-groups',
  webhookIntroduction: '/others/webhooks/introduction',
  webhookEventType: '/others/webhooks/event-type',
  webhookRetries: '/others/webhooks/retries',
  webhookVerifyRequests: '/others/webhooks/verify-requests',
  dynamicTemplates: '/dynamic-templates',
  guides: '/guides',
  sitemap: '/sitemap.xml',
  team: '/others/team',
  automations: '/automations',
  events: '/automations/events',
  sendEventApi: '/api-reference/events/send-event',
  smtpIntroduction: '/quickstart/smtp',
  betterAuth: '/guides/better-auth',
  convexGuide: '/guides/convex',
  templateVariables: '/transactional-emails/variables',
  suppressions: '/others/suppressions',
  rateLimit: '/api-reference/rate-limit',
  nodejsSdk: '/sdk/nodejs',
  smtpIntegrationGuides: '/guides/smtp',
  apiKeys: '/api-keys',
  encryptedPayloads: '/others/encrypted-payloads',
  apiReferenceIntroduction: '/api-reference/introduction',
  lovableGuide: '/ai/integrations/lovable',
  aiIntroduction: '/ai/introduction',
  aiSkills: '/ai/skills',
  aiMcpServer: '/ai/mcp-server',
  aiLovable: '/ai/integrations/lovable',
  aiBolt: '/ai/integrations/bolt',
  aiV0: '/ai/integrations/v0',
  aiReplit: '/ai/integrations/replit',
  mcpClaude: '/ai/mcp-clients/claude',
  mcpCursor: '/ai/mcp-clients/cursor',
  mcpCopilot: '/ai/mcp-clients/copilot',
  mcpWindsurf: '/ai/mcp-clients/windsurf',
  mcpCodex: '/ai/mcp-clients/codex',
  mcpAntigravity: '/ai/mcp-clients/antigravity',
  mcpChatgpt: '/ai/mcp-clients/chatgpt',
  mcpRaycast: '/ai/mcp-clients/raycast',
  domainWarmup: '/marketing-emails/domain-warmup',
  projects: '/projects',
  createAutomationApi: '/api-reference/automations/create-automation',
  migrationSendgrid: '/migration/sendgrid',
  migrationResend: '/migration/resend',
  auth0CustomAction: '/guides/auth0-custom-action',
  accountBilling: '/others/account/billing',
  accountUsage: '/others/account/usage',
  inboundIntroduction: '/inbound/introduction',
  listInboundMessagesApi: '/api-reference/inbound-emails/list-messages',
  getInboundMessageApi: '/api-reference/inbound-emails/get-message',
  downloadInboundAttachmentApi: '/api-reference/inbound-emails/download-attachment',
  replyToInboundMessageApi: '/api-reference/inbound-emails/reply-to-message',
  wikiDailySendingLimit: '/wiki/daily-sending-limit'
};

export const AUTOSEND_PATHS = {
  dashboard: 'https://autosend.com/dashboard',
  apiKey: 'https://autosend.com/account/api-key',
  faqs: 'https://autosend.com/faq',
  marketingEmails: 'https://autosend.com/marketing-emails',
  webhooks: 'https://autosend.com/webhooks',
  composeByAutoSend: 'https://autosend.com/compose',
  emailActivity: 'https://autosend.com/email-activities',
  team: 'https://autosend.com/settings/team',
  pricing: 'https://autosend.com/pricing',
  verifyEmail: 'https://autosend.com/compose/email-builder?template=verify-email',
  welcomeEmail: 'https://autosend.com/compose/email-builder?template=welcome-email',
  productUpdate: 'https://autosend.com/compose/email-builder?template=product-update',
  newsletter: 'https://autosend.com/compose/email-builder?template=newsletter',
  automations: 'https://autosend.com/automations',
  globalSuppressions: 'https://autosend.com/suppressions/global',
  signup: 'https://autosend.com/signup',
  domains: 'https://autosend.com/settings/domains',
  smtpKey: 'https://autosend.com/settings/smtp',
  logoKit: 'https://asend.email/logo',
  contactsPage: 'https://autosend.com/contacts/list-and-segments',
  accountBilling: 'https://autosend.com/account/billing',
  accountUsage: 'https://autosend.com/account/usage',
  terms: 'https://autosend.com/legal/terms',
  inbound: 'https://autosend.com/email-activities/inbound'
};

<Frame>
  <img src="https://mintcdn.com/autosend-13920f5c/9RYyFcIHf2w6O1Z8/images/smtp/autosendxauth0.jpg?fit=max&auto=format&n=9RYyFcIHf2w6O1Z8&q=85&s=59c13254c5f26e7d1e80530fbeebe805" alt="AutoSend x Auth0" width="1800" height="600" data-path="images/smtp/autosendxauth0.jpg" />
</Frame>

Auth0 uses email for authentication flows like password resets, email verification, and passwordless login. By default, Auth0 uses its built-in email provider, but you can configure it to use AutoSend SMTP for better deliverability and email tracking.

<Note>
  If SMTP doesn't work for your Auth0 tenant, you can call the AutoSend API directly from a Custom Email Provider Action instead. See <a href={APP_PATHS.auth0CustomAction}>Send emails from Auth0 with a Custom Email Provider Action</a>.
</Note>

## Prerequisites

<CardGroup cols={2}>
  <Card title="Verified Domain" href="https://autosend.com/settings/domains">
    Make sure you have a verified domain added in AutoSend to send emails from.
  </Card>

  <Card title="SMTP Key" href={AUTOSEND_PATHS.smtpKey}>
    Create a project-specific SMTP key from the SMTP tab in Project Settings.
  </Card>
</CardGroup>

## Configuration

<Steps>
  <Step title="Navigate to Email Provider Settings" titleSize="h3">
    1. Log in to your [Auth0 Dashboard](https://manage.auth0.com/)
    2. Go to **Branding** in the sidebar
    3. Click on **Email Provider**

    <Frame>
      <img src="https://mintcdn.com/autosend-13920f5c/_eFBHIwI_XbpfYB_/images/smtp/auth0-step-1.png?fit=max&auto=format&n=_eFBHIwI_XbpfYB_&q=85&s=92a2e7bea90dc930218ac73f68e500ec" alt="Supabase Step 1" width="2020" height="1366" data-path="images/smtp/auth0-step-1.png" />
    </Frame>
  </Step>

  <Step title="Enable Custom Email Provider" titleSize="h3">
    Toggle **Use my own email provider** to enable custom SMTP configuration.

    <Frame>
      <img src="https://mintcdn.com/autosend-13920f5c/_eFBHIwI_XbpfYB_/images/smtp/auth0-step-2.png?fit=max&auto=format&n=_eFBHIwI_XbpfYB_&q=85&s=25ce871aeb041260548ab9cb595ea882" alt="Supabase Step 2" width="2206" height="1284" data-path="images/smtp/auth0-step-2.png" />
    </Frame>
  </Step>

  <Step title="Select SMTP Provider" titleSize="h3">
    Select **SMTP Provider** as your email provider type.

    <Frame>
      <img src="https://mintcdn.com/autosend-13920f5c/_eFBHIwI_XbpfYB_/images/smtp/auth0-step-3.png?fit=max&auto=format&n=_eFBHIwI_XbpfYB_&q=85&s=c9eae44b64f43a7f0bd9c2d517691b56" alt="Supabase Step 3" width="2158" height="1122" data-path="images/smtp/auth0-step-3.png" />
    </Frame>
  </Step>

  <Step title="Enter SMTP Credentials" titleSize="h3">
    Fill in the following settings:

    | Field             | Value                                                      |
    | ----------------- | ---------------------------------------------------------- |
    | **From**          | `noreply@yourdomain.com` (must match your verified domain) |
    | **SMTP Host**     | `smtp.autosend.com`                                        |
    | **SMTP Port**     | `587`                                                      |
    | **SMTP Username** | `autosend`                                                 |
    | **SMTP Password** | Your AutoSend SMTP key (AS\_xxx)                           |

    <Note>
      The SMTP password is no longer your API key. Create a project-specific SMTP key from the SMTP tab in <a href={AUTOSEND_PATHS.smtpKey} target="_blank" rel="noopener noreferrer">Project Settings</a>.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/autosend-13920f5c/_eFBHIwI_XbpfYB_/images/smtp/auth0-step-4.png?fit=max&auto=format&n=_eFBHIwI_XbpfYB_&q=85&s=2fc170b895d371e313df40d36aa53951" alt="Supabase Step 4" width="1978" height="1456" data-path="images/smtp/auth0-step-4.png" />
    </Frame>
  </Step>

  <Step title="Save Configuration" titleSize="h3">
    Click **Save** to apply your SMTP settings.
  </Step>

  <Step title="Send a Test Email" titleSize="h3">
    After saving, click the **Send Test** button next to the Save button to send a test email and verify your configuration is working.

    You can also check the <a href={AUTOSEND_PATHS.emailActivity} target="_blank" rel="noopener noreferrer">Email Activity</a> dashboard to verify the email was sent through AutoSend.

    <Frame>
      <img src="https://mintcdn.com/autosend-13920f5c/_eFBHIwI_XbpfYB_/images/smtp/auth0-step-5.png?fit=max&auto=format&n=_eFBHIwI_XbpfYB_&q=85&s=7835757914d341f4054081aa3f4ac0b9" alt="Supabase Step 5" width="2596" height="738" data-path="images/smtp/auth0-step-5.png" />
    </Frame>
  </Step>
</Steps>

## Email Templates

Auth0 allows you to customize email templates for different authentication scenarios. Navigate to **Branding** → **Email Templates** to modify:

* **Verification Email** - Sent when users need to verify their email address
* **Welcome Email** - Sent after successful signup
* **Change Password** - Sent for password reset requests
* **Blocked Account** - Sent when an account is blocked
* **Passwordless Email** - Sent for passwordless authentication (magic links/codes)

<Note>
  Auth0 email templates use Liquid syntax for dynamic content. Variables like `{{ user.email }}` and `{{ url }}` are replaced with actual values when the email is sent.
</Note>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Emails not being sent">
    * Verify your SMTP credentials are correct - Check that your sender email domain is verified in
      AutoSend - Ensure the From address matches a verified domain - Check Auth0 logs for SMTP
      connection errors (**Monitoring** → **Logs**)
  </Accordion>

  <Accordion title="Authentication failed">
    * Double-check your SMTP key is correct - Ensure you're using `autosend` as the username - Verify
      your SMTP key is active in the <a href={AUTOSEND_PATHS.smtpKey} target="_blank" rel="noopener noreferrer">SMTP Settings</a>
  </Accordion>

  <Accordion title="Connection errors">
    * Verify the hostname is `smtp.autosend.com` - Try using port `465` with implicit TLS if port
      `587` fails - Check if your network blocks outbound SMTP connections
  </Accordion>

  <Accordion title="Emails going to spam">
    * Ensure your domain has proper DNS records (SPF, DKIM, DMARC) - Use a professional sender name,
      not just "noreply" - Check your domain reputation in AutoSend
  </Accordion>

  <Accordion title="SMTP still won't work?">
    If SMTP fails after exhausting the steps above, switch to the API-based approach using Auth0's Custom Email Provider Action. See <a href={APP_PATHS.auth0CustomAction}>Send emails from Auth0 with a Custom Email Provider Action</a>.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Verify Your Domain" icon="https://mintcdn.com/autosend-13920f5c/nx_wYfWx3qeZwg1C/icons/domain.svg?fit=max&auto=format&n=nx_wYfWx3qeZwg1C&q=85&s=9393f9f9b0f7029e6ba8acf2bc09d864" href="/domain" width="24" height="24" data-path="icons/domain.svg">
    Set up SPF, DKIM, and DMARC for better deliverability
  </Card>

  <Card title="Email Activity" icon="https://mintcdn.com/autosend-13920f5c/nx_wYfWx3qeZwg1C/icons/email-activity.svg?fit=max&auto=format&n=nx_wYfWx3qeZwg1C&q=85&s=2ecad7369f217ee7d03c3d8dfdd36d22" href="/transactional-emails/email-activity" width="24" height="24" data-path="icons/email-activity.svg">
    Monitor your email delivery and engagement
  </Card>

  <Card title="Webhooks" icon="https://mintcdn.com/autosend-13920f5c/nx_wYfWx3qeZwg1C/icons/webhook.svg?fit=max&auto=format&n=nx_wYfWx3qeZwg1C&q=85&s=14ad6675c71731ac04f786559a813ee1" href="/others/webhooks/introduction" width="24" height="24" data-path="icons/webhook.svg">
    Set up webhooks to track email events in real-time
  </Card>

  <Card title="SMTP Introduction" icon="https://mintcdn.com/autosend-13920f5c/nx_wYfWx3qeZwg1C/icons/smtp.svg?fit=max&auto=format&n=nx_wYfWx3qeZwg1C&q=85&s=d1993edda392d54c3f704a9a4bb04442" href="/quickstart/smtp" width="24" height="24" data-path="icons/smtp.svg">
    Learn more about AutoSend SMTP configuration
  </Card>
</CardGroup>
