Skip to main content

Email API Guide

Use the Email API to programmatically initiate email conversations using Revmo's agent system. Each email thread can be managed by an AI agent that handles responses and follow-ups automatically.

Below, learn the basic methods of managing email conversations through the API. To view all available endpoints and their requirements, check out the API reference documentation.

note

Outbound email functionality is available on a per-account basis. If you need access to email capabilities, please contact support@revmo.ai.

Create an Outbound Email Thread​

To create an outbound email thread, make a POST request to /v1/startemail/.

In the request body, add email details and any required metadata. You'll need to authenticate your request using your API key, which you can find in your account settings.

Properties​

In the request body, you can include the following fields:

FieldTypeRequiredDescription
agentIdstringYesYour Agent ID from the Revmo platform. Located on your account page.
tostringYesThe destination email address.
subjectstringYesThe subject line for the email thread.
triggerstringNoThe trigger phrase that launches the appropriate task for your agent.
metadataobjectNoAdditional key-value pairs of information for the Agent to use during the conversation.

Example Request​

import requests

HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY"
}

DATA = {
    "agentId": "YOUR_AGENT_ID",
    "to": "customer@example.com",
    "subject": "Following up on your recent purchase",
    "trigger": "purchase_followup",
    "metadata": {
        "customer_name": "John Doe",
        "purchase_date": "2025-02-20",
        "product": "Premium Package"
    }
}

response = requests.post(
    "https://api.revmo.ai/v1/startemail/",
    json=DATA,
    headers=HEADERS
)

Managing Email Conversations​

All email conversations can be managed through the Conversations page on our web interface. The interface provides several powerful features:

  • Monitor email threads and conversation history in real-time
  • Take over conversations manually when needed
  • Enable or disable the AI agent for specific threads
  • Send direct email responses to customers
  • View conversation metadata and context

The agent can handle various email-related tasks:

  • Respond to customer inquiries
  • Send follow-up emails
  • Schedule meetings
  • Provide product information
  • Escalate to human agents when necessary

Best Practices​

  1. Email Address Validation

    • Validate email addresses before sending
    • Handle bounce notifications appropriately
    • Maintain clean email lists

  2. Content Guidelines

    • Use clear and professional subject lines
    • Include unsubscribe options when required
    • Follow email compliance regulations
    • Keep content relevant and concise

  3. Technical Implementation

    • Implement retry logic for failed sends
    • Monitor delivery and open rates
    • Store ThreadIds for future reference
    • Handle webhook notifications reliably

  4. Testing

    • Use test email addresses before production deployment
    • Verify webhook functionality
    • Test different trigger scenarios
    • Validate metadata handling

Rate Limits​

Default rate limits apply to protect the system from abuse. Contact support for specific limits for your account type.

Compliance​

When using the Email API, ensure you comply with relevant email regulations such as:

  • CAN-SPAM Act requirements
  • GDPR guidelines for EU recipients
  • Local email marketing laws
  • Professional email communication standards

Additional Resources​