> ## 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 Descope with SMTP

> Configure Descope 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/autosendxdescope.jpg?fit=max&auto=format&n=9RYyFcIHf2w6O1Z8&q=85&s=932d6aa64ab36cc05c9a0d6b08e47041" alt="AutoSend x Descope" width="1800" height="600" data-path="images/smtp/autosendxdescope.jpg" />
</Frame>

Descope uses email for authentication flows like OTP verification, magic links, and password resets. By default, Descope uses its built-in email delivery, but you can configure it to use AutoSend SMTP for better deliverability and email tracking.

## 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="Open Descope Connectors" titleSize="h3">
    1. Go to your [Descope Console](https://app.descope.com/)
    2. Navigate to **Connectors** in the sidebar.

    <Frame>
      <img src="https://mintcdn.com/autosend-13920f5c/zhR7iTSILkOz25zn/images/smtp/descope-step-1.png?fit=max&auto=format&n=zhR7iTSILkOz25zn&q=85&s=6dad418ba933b86905bea193057d9e81" alt="AutoSend x Descope" width="2506" height="1460" data-path="images/smtp/descope-step-1.png" />
    </Frame>
  </Step>

  <Step title="Search SMTP Connector" titleSize="h3">
    1. Search for **SMTP**
    2. Click the SMTP card to create a new SMTP connector.

    <Frame>
      <img src="https://mintcdn.com/autosend-13920f5c/zhR7iTSILkOz25zn/images/smtp/descope-step-2.png?fit=max&auto=format&n=zhR7iTSILkOz25zn&q=85&s=1d1b592c09ff486b742b5583ef15344b" alt="AutoSend x Descope" width="2528" height="1466" data-path="images/smtp/descope-step-2.png" />
    </Frame>
  </Step>

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

    | Field               | Value                                                      |
    | ------------------- | ---------------------------------------------------------- |
    | **Connector Name**  | `AutoSend` (or your preferred name)                        |
    | **Server Hostname** | `smtp.autosend.com`                                        |
    | **SMTP Port**       | `587`                                                      |
    | **Username**        | `autosend`                                                 |
    | **Password**        | Your AutoSend SMTP key (AS\_xxx)                           |
    | **Sender Address**  | `noreply@yourdomain.com` (must match your verified domain) |
    | **Sender Name**     | Your app name (e.g., "MyApp")                              |

    <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/zhR7iTSILkOz25zn/images/smtp/descope-step-3.png?fit=max&auto=format&n=zhR7iTSILkOz25zn&q=85&s=18cb2b76673750787a7ee7de76a730f5" alt="AutoSend x Descope" width="2526" height="2104" data-path="images/smtp/descope-step-3.png" />
    </Frame>
  </Step>

  <Step title="Test Configuration" titleSize="h3">
    Click the **Test** button to verify your SMTP configuration is working correctly. Check the Test Results panel for success or error details.

    <Frame>
      <img src="https://mintcdn.com/autosend-13920f5c/zhR7iTSILkOz25zn/images/smtp/descope-step-4.png?fit=max&auto=format&n=zhR7iTSILkOz25zn&q=85&s=5edce2a64ed2cbb531d56344b7076bab" alt="AutoSend x Descope" width="2522" height="2102" data-path="images/smtp/descope-step-4.png" />
    </Frame>
  </Step>

  <Step title="Save Connector" titleSize="h3">
    Click **Create** to save your SMTP connector.
  </Step>

  <Step title="Use in Authentication Flows" titleSize="h3">
    1. Navigate to **Flows** in Descope
    2. Select or create your authentication flow
    3. Add a connector action where email sending is needed
    4. Select your AutoSend SMTP connector
    5. Configure the email recipient (typically `{{user.email}}`)
  </Step>
</Steps>

## Dynamic Values

Descope supports dynamic values in sender fields using template syntax:

* **Sender Address/Name**: Use `{{options_<value>}}` format for dynamic sender configuration
* **Recipient**: Set the `To` field dynamically with `{{user.email}}`

Refer to Descope's [Dynamic Values documentation](https://docs.descope.com/flows/dynamic-keys) to learn how to set dynamic values when using messaging connectors.

## 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 sender address matches a verified domain
    * Check Descope connector test results for specific errors
  </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>
</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>
