Skip to main content

​
Overview

The Nautilus API allows authorized external systems to interact with the Nautilus platform programmatically.

​
Base URL

https://app.nautilus.co/api

​
Authentication

All endpoints require a Bearer token passed in the Authorization header. 
curl -X POST https://app.nautilus.co/api/v1/message \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "+15551234567", "body": "Hello from Nautilus!"}'
Requests with a missing or invalid token receive a 401 Unauthorized response.

​
Key types

Nautilus issues two kinds of API keys:
  • Tenant-scoped keys — bound to a specific organization. Sends are attributed to that tenant and use the tenant’s own sender identity (email from your slug-derived address on @mail.nautilus.co, SMS from your configured tenant phone number).
  • Platform keys — legacy Nautilus-issued keys that send as the Nautilus brand (SMS from the Nautilus shortcode, email from contact@mail.nautilus.co).
Most integrations use tenant-scoped keys. Contact Nautilus to provision one for your organization.