Skip to main content

Documentation Index

Fetch the complete documentation index at: https://ahasend.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

AhaSend retains message data and metadata for 30 days by default to support email delivery tracking, auditing, and troubleshooting. You can customize these retention periods to comply with legal requirements or privacy policies, especially when handling sensitive information like financial, health, or legal data.
Compliance Ready: Customize retention periods to meet regulatory requirements for your industry.

​
Message Data vs Metadata

Understanding the difference between data and metadata helps you set appropriate retention policies:
Minimal tracking information kept for delivery monitoring:
  • Message ID and email subject
  • From and recipient email addresses
  • Message direction (outbound/inbound)
  • Delivery status (received, delivered, bounced, failed)
  • Delivery attempt logs and timestamps
Retention: Minimum 1 day, maximum 30 days
Complete email content and details:
  • All email headers
  • HTML and plain text body content
  • File attachments
  • Full message payload
Retention: 0-30 days (can be completely disabled)

​
Account-Wide Settings

Configure default retention periods for your entire account:

Access Retention Settings

  1. Log in to your AhaSend Dashboard
  2. Navigate to Account Settings
  3. Find the Retention Policy section

Set Default Periods

Configure retention periods:
  • Message Metadata: 1-30 days (default: 30 days)
  • Message Data: 0-30 days (default: 30 days)
Minimum Requirements: Message metadata requires at least 1 day retention for delivery tracking. Message data can be set to 0 days for immediate deletion.

Save Changes

Apply settings to all future emails sent through your account.
Existing Data: Changes only affect new emails. Previously sent emails retain their original retention settings.

​
Per-Message Overrides

Override account defaults for specific emails using special headers:

​
SMTP Headers

When sending via SMTP, add these headers to individual emails: 
ahasend-metadata-retention: 7
ahasend-data-retention: 0
Controls metadata retention period:
  • Value: Integer between 1 and 30 (days)
  • Purpose: Set how long delivery tracking data is kept
  • Example: ahasend-metadata-retention: 7 (keep for 7 days)
Controls full email data retention:
  • Value: Integer between 0 and 30 (days)
  • Purpose: Set how long complete email content is stored
  • Example: ahasend-data-retention: 0 (delete immediately)

​
API v1 Implementation

For API v1, include retention headers in your message payload: 
{
  "from": {
    "email": "hello@yourdomain.com",
    "name": "Your Company"
  },
  "recipients": [
    {
      "email": "user@example.com",
      "name": "John Doe"
    }
  ],
  "content": {
    "subject": "Sensitive Information",
    "text_body": "This email contains sensitive data.",
    "headers": {
      "ahasend-metadata-retention": "1",
      "ahasend-data-retention": "0"
    }
  }
}

​
API v2 Implementation

For API v2, use the dedicated retention fields: 
{
  "from": {
    "email": "hello@yourdomain.com",
    "name": "Your Company"
  },
  "recipients": [
    {
      "email": "user@example.com",
      "name": "John Doe"
    }
  ],
  "subject": "Sensitive Information",
  "text_content": "This email contains sensitive data.",
  "retention": {
    "metadata": 1,
    "data": 0
  }
}
Full API v2 Documentation: See the Create Message API reference for complete documentation on all available fields and options.
Header Removal: Retention headers are automatically removed before email delivery and never visible to recipients.

​
Common Use Cases

Compliance Requirements:
  • Short retention for sensitive financial data
  • Metadata retention for audit trails
Recommended Settings:
  • Metadata: 7-30 days
  • Data: 0-1 days for sensitive emails
HIPAA Compliance:
  • Minimal retention of patient information
  • Quick deletion of medical data
Recommended Settings:
  • Metadata: 1-7 days
  • Data: 0 days for patient emails
Campaign Tracking:
  • Longer retention for analytics
  • Full content for A/B testing
Recommended Settings:
  • Metadata: 30 days
  • Data: 30 days
Order Confirmations:
  • Medium retention for customer service
  • Balance between utility and privacy
Recommended Settings:
  • Metadata: 30 days
  • Data: 7-14 days

​
Best Practices

Develop a Retention Policy:
  • Review legal requirements for your industry
  • Consider customer privacy expectations
  • Document your retention decisions
  • Regularly audit and update policies
Implementation Tips:
  • Start with shorter periods and extend if needed
  • Use per-message overrides for sensitive content
  • Monitor compliance with internal policies
Balance Compliance and Functionality:
  • Keep metadata longer for delivery troubleshooting
  • Delete sensitive data quickly while retaining delivery records
  • Consider customer service needs for support queries
Monitoring:
  • Track delivery issues that may require message data
  • Review retention effectiveness regularly
  • Adjust policies based on operational needs

Special Headers

Complete reference for SMTP headers including retention

API Reference

API documentation for setting retention in message requests