workflows

Hosted Workflows

Manage API-backed workflows that connect booking events to hosted templates.

nylas workflow list
nylas workflow create --name "Booking Confirmation" --template-id tpl_123 --trigger-event booking.created
nylas workflow show <workflow-id>
nylas workflow update <workflow-id> --disabled
nylas workflow delete <workflow-id> --yes

Scopes:

• --scope app for application-level workflows
• --scope grant --grant-id <id> for grant-level workflows

Typical flow:

1. Create a hosted template with nylas template create
2. Create a workflow that points at that template with nylas workflow create
3. Verify the rendered email with nylas email send --template-id ... --render-only

---

Advanced Automation Workflows

Complex automation workflows and integration patterns that span multiple Nylas CLI commands.

---

OTP Extraction

Extract OTP codes from emails:

# Get latest OTP
nylas otp get

# Get OTP from specific service
nylas otp get --from "[email protected]"

# Watch for OTP (poll every 5 seconds)
while true; do
  otp=$(nylas otp get)
  if [ -n "$otp" ]; then
    echo "OTP received: $otp"
    echo "$otp" | pbcopy  # Copy to clipboard (macOS)
    break
  fi
  sleep 5
done

---

Automated login with OTP:

#!/bin/bash
# auto-login-with-otp.sh

SERVICE_URL="https://app.example.com/login"
USERNAME="[email protected]"

# Step 1: Request OTP
curl -X POST "$SERVICE_URL/request-otp" -d "email=$USERNAME"
echo "OTP requested. Waiting for email..."

# Step 2: Wait and extract OTP
sleep 10
OTP=$(nylas otp get --from "[email protected]")

if [ -z "$OTP" ]; then
  echo "Failed to receive OTP"
  exit 1
fi

# Step 3: Login with OTP
curl -X POST "$SERVICE_URL/login" -d "email=$USERNAME&otp=$OTP"
echo "Login successful!"

---

OTP monitoring service (Python):

#!/usr/bin/env python3
# otp-monitor.py

import subprocess
import time
import re

def get_latest_otp():
    """Get OTP using Nylas CLI"""
    result = subprocess.run(
        ['nylas', 'otp', 'get'],
        capture_output=True,
        text=True
    )

    if result.returncode == 0:
        match = re.search(r'\b\d{6}\b', result.stdout)
        if match:
            return match.group(0)
    return None

def monitor_otp(callback, timeout=60):
    """Monitor for OTP and call callback when received"""
    start_time = time.time()

    while time.time() - start_time < timeout:
        otp = get_latest_otp()
        if otp:
            callback(otp)
            return True
        time.sleep(5)

    return False

if __name__ == '__main__':
    print("Monitoring for OTP...")
    success = monitor_otp(lambda code: print(f"OTP: {code}"), timeout=120)
    if not success:
        print("Timeout waiting for OTP")