Send Email

curl -X POST "https://api.daimon.email/v1/inboxes/inb_abc123/send" \
  -H "Authorization: Bearer dm_live_7d8a9b0c1d2e3f4g5h6i7j8k9l0m1n2o" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example.com",
    "subject": "Hello from my agent",
    "body": "This is my first email sent via daimon.email!",
    "client_id": "send-001"
  }'

const client = new DaimonClient({ apiKey: 'dm_live_...' });

try {
  const sent = await client.inboxes.send('inb_abc123', {
    to: 'user@example.com',
    subject: 'Hello from my agent',
    body: 'This is my first email sent via daimon.email!',
    clientId: 'send-001'
  });

  console.log(`Sent! Message ID: ${sent.message_id}`);
  console.log(`Status: ${sent.status}`);
} catch (error) {
  if (error.code === 'SEND_REQUIRES_PAID') {
    // Agent autonomously handles upgrade flow
    console.log('Agent script:', error.upgradeContext.agentScript);
    // Outputs: "Tell your operator: I need sending access. Here's a direct upgrade link: https://..."

    // Generate magic upgrade link
    const upgradeLink = await client.account.createUpgradeLink();
    console.log('Upgrade URL:', upgradeLink.url);
  }
}

client = DaimonClient(api_key='dm_live_...')

try:
    sent = client.inboxes.send('inb_abc123', {
        'to': 'user@example.com',
        'subject': 'Hello from my agent',
        'body': 'This is my first email sent via daimon.email!',
        'client_id': 'send-001'
    })

    print(f"Sent! Message ID: {sent.message_id}")
    print(f"Status: {sent.status}")
except DaimonError as e:
    if e.code == 'SEND_REQUIRES_PAID':
        # Agent autonomously handles upgrade flow
        print('Agent script:', e.upgrade_context['agent_script'])
        # Outputs: "Tell your operator: I need sending access. Here's a direct upgrade link: https://..."

        # Generate magic upgrade link
        upgrade_link = client.account.create_upgrade_link()
        print('Upgrade URL:', upgrade_link.url)

{
  "result": {
    "id": "msg_sent123",
    "status": "sent",
    "message_id": "<abc123@daimon.email>",
    "sent_at": "2024-03-11T14:23:45Z",
    "note": null
  },
  "next_steps": [
    "Message delivered successfully",
    "Check /v1/inboxes/{id}/messages for replies",
    "Monitor webhooks for message.reply events"
  ]
}

{
  "result": {
    "id": "msg_sched456",
    "status": "scheduled",
    "message_id": "<def456@daimon.email>",
    "sent_at": null,
    "scheduled_at": "2024-03-12T09:00:00Z",
    "note": "Scheduled for delivery at 2024-03-12T09:00:00Z"
  },
  "next_steps": [
    "Message scheduled for future delivery",
    "Call DELETE /v1/inboxes/{id}/scheduled/{id} to cancel",
    "Message will appear in /v1/inboxes/{id}/messages after delivery"
  ]
}

{
  "error": "SEND_REQUIRES_PAID",
  "message": "Sending emails requires a paid tier subscription",
  "upgrade_context": {
    "operator_action_url": "https://daimon.email/upgrade?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "operator_action_label": "Add a payment method to enable sending",
    "agent_script": "Tell your operator: I need sending access. Here's a direct upgrade link: https://daimon.email/upgrade?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  },
  "next_steps": [
    "Present the operator_action_url to your human operator",
    "Or call POST /v1/upgrade-link to generate a new magic upgrade link",
    "After upgrade, retry this request with the same client_id for idempotency"
  ]
}

{
  "error": "SEND_LIMIT_EXCEEDED",
  "message": "Monthly send limit reached (100/100). Upgrade to increase limit.",
  "upgrade_context": {
    "operator_action_url": "https://daimon.email/upgrade?token=...",
    "operator_action_label": "Upgrade to Pro for 10,000 sends/month",
    "agent_script": "Tell your operator: I've hit the monthly send limit. Here's an upgrade link: https://daimon.email/upgrade?token=..."
  },
  "next_steps": [
    "Present the upgrade link to your operator",
    "Or wait until the next billing cycle (resets on the 1st of each month)"
  ]
}