Setup Guide

Google blocks regular password login for third-party apps. You need a 16-character App Password - it bypasses 2-Step Verification for a single app.

1. 1

   Enable 2-Step Verification

   Go to myaccount.google.com → Security → 2-Step Verification. Complete the setup if you haven't already.

2. 2

   Open App Passwords

   Search "App Passwords" in the Google Account search bar (or go to myaccount.google.com → Security → App Passwords). Sign in again if prompted.

3. 3

   Create a new App Password

   Under "Select app" choose Mail. Under "Select device" choose Other and type "ORYXLY". Click Generate.

4. 4

   Copy the 16-character password

   Google shows the password once. Copy it now - you cannot see it again.

5. 5

   Add SMTP in ORYXLY

   Go to SMTP → Add connection. Use these settings:

   Host:  smtp.gmail.com
   Port:  587
   TLS:   STARTTLS
   User:  [email protected]
   Pass:  (the 16-character app password)

Microsoft accounts support SMTP AUTH but it must be enabled on your tenant. Use an App Password when MFA is active.

1. 1

   Check SMTP AUTH is on

   Ask your M365 admin to confirm SMTP AUTH is enabled for your mailbox (Exchange Admin Center → Users → your mailbox → Mail → SMTP AUTH).

2. 2

   Generate an App Password (MFA accounts only)

   Go to account.microsoft.com → Security → Advanced security options → App passwords → Create a new app password. Copy the generated password.

3. 3

   Add SMTP in ORYXLY

   Use these settings for personal Outlook or Microsoft 365:

   Host:  smtp.office365.com
   Port:  587
   TLS:   STARTTLS
   User:  [email protected]
   Pass:  (app password or account password if no MFA)

4. 4

   For Hotmail / Outlook.com

   Settings are identical - same host, port, and TLS. Just replace the email with your @hotmail.com or @outlook.com address.

Zoho Mail supports SMTP for both free and paid plans. Use an application-specific password when two-factor authentication is enabled.

1. 1

   Enable Two-Factor Authentication (optional but recommended)

   accounts.zoho.com → Security → Two-Factor Authentication → Set up now.

2. 2

   Generate Application Password

   accounts.zoho.com → Security → App Passwords → Generate New Password. Name it ORYXLY and copy the password shown.

3. 3

   Add SMTP in ORYXLY

   Use these settings:

   Host:  smtp.zoho.in   (India)  or  smtp.zoho.com  (global)
   Port:  587
   TLS:   STARTTLS
   User:  [email protected]
   Pass:  (app password)

4. 4

   Verify with a test send

   ORYXLY sends a test email to your address when you save the connection. Check your inbox to confirm delivery.

SendGrid exposes a full SMTP relay. You authenticate with your account username and an API key as the password - no app-password flow needed.

1. 1

   Create an API Key

   Log in at app.sendgrid.com → Settings → API Keys → Create API Key. Choose Restricted Access, enable only Mail Send → Full Access. Copy the key - it is shown once.

2. 2

   Add SMTP in ORYXLY

   Use these exact settings:

   Host:  smtp.sendgrid.net
   Port:  587
   TLS:   STARTTLS
   User:  apikey            ← literal string, not your email
   Pass:  SG.xxxxxxxxxxxx   ← your API key

3. 3

   Verify sender identity

   SendGrid requires your From address to be verified. Go to Settings → Sender Authentication and either verify a single sender or authenticate a whole domain.

4. 4

   Check sending limits

   Free SendGrid accounts are capped at 100 emails/day. Ensure your SendGrid plan covers the volume you intend to send through ORYXLY.

SMTP is the engine ORYXLY uses to deliver your campaigns. You must add at least one connection before creating a campaign.

1. 1

   Go to SMTP

   Open the SMTP page from the top navigation inside your dashboard.

2. 2

   Add a connection

   Click Add connection. Enter the host, port, username, and password for your provider. Choose STARTTLS on port 587 (recommended) or SSL/TLS on port 465.

3. 3

   Test the connection

   ORYXLY sends a test email to your own address immediately after you save. If it fails, check credentials and that SMTP AUTH is enabled for your account.

4. 4

   Add more connections (Growth/Agency)

   Growth plans allow 3 connections; Agency allows 10. You can round-robin across them in future campaigns.

ORYXLY accepts contact lists as CSV, XLSX, or XLS files up to 10 MB. Each file becomes a named list you can reuse across campaigns.

1. 1

   Prepare your file

   Your file must have a header row. Include at minimum an email column. Add any other columns you want to use as personalisation variables (e.g. first_name, company, position).

   email,first_name,company
   [email protected],John,Acme
   [email protected],Jane,Beta Co

2. 2

   Upload the list

   Go to Contacts → Upload. Name the list and select your file. ORYXLY validates every row and removes duplicates automatically.

3. 3

   Review the import

   After upload you see a count of valid, duplicate, and invalid rows. Invalid rows (missing or malformed emails) are skipped and logged.

A campaign ties together a sender, a contact list, and your email content. The 6-step wizard walks you through each part.

1. 1

   Name your campaign

   Give it an internal name you'll recognise in your logs (e.g. 'Q3 export outreach - July').

2. 2

   Choose a sender

   Select one of your verified SMTP connections as the sending account.

3. 3

   Select your audience

   Pick a contact list. ORYXLY shows a preview row count.

4. 4

   Map variables

   ORYXLY detects the columns in your list. Choose which column is the recipient email address (the 'to' variable).

5. 5

   Write your content

   Write the subject line and HTML body. Reference any list column with double curly braces:

   Subject: Hey {{first_name}}, a quick note about {{company}}
   Body:    Hi {{first_name}}, ...

6. 6

   Review and launch

   The review step renders a live preview with a real contact row. When you're happy, click Launch. The campaign enters the queue and workers begin sending.

Every message ORYXLY attempts to send gets a log entry. Use Logs to track delivery, diagnose failures, and audit sends.

1. 1

   Find the Logs page

   Click Logs in the top navigation. You see all messages across all campaigns, newest first.

2. 2

   Understand status values

   sent - delivered to your SMTP server. failed - all retries exhausted; expand the row to see the SMTP error. pending - queued, not yet attempted.

3. 3

   Debug a failed send

   Click any failed row to expand it. The full SMTP error response is shown - e.g. 'Invalid credentials' or '550 5.1.1 recipient not found'. Fix the root cause (credentials, recipient address) and re-launch if needed.

You can pause a running campaign or cancel it entirely from the campaign detail page.

1. 1

   Open the campaign

   Go to Campaigns and click the campaign name.

2. 2

   Pause sending

   Click Pause. Workers stop picking up new messages for that campaign. Queued messages not yet attempted stay in the queue.

3. 3

   Resume or cancel

   Click Resume to continue from where you left off. Click Cancel to mark the campaign cancelled - remaining queued messages are discarded.