Inbify Backend

Register a new user. Returns user data with JWT access + refresh tokens.

{
  "email": "user@example.com",
  "full_name": "John Doe",
  "password": "securePass123",
  "password_confirm": "securePass123"
}

Returns JWT tokens and full user data including subscription info.

// Request
{ "email": "user@example.com", "password": "securePass123" }

// Response
{
  "access": "eyJ...",
  "refresh": "eyJ...",
  "user": { "id": "uuid", "email": "...", "full_name": "..." }
}

{ "refresh": "eyJ..." }

// Request:  { "refresh": "eyJ..." }
// Response: { "access": "eyJ...", "refresh": "eyJ..." }

Returns user profile: id, email, full_name, avatar, onboarding_completed.

{ "full_name": "New Name" }

{ "old_password": "...", "new_password": "..." }

Returns user + subscription + all email accounts + 20 recent emails. Also triggers background sync for stale accounts (>5 min old).

Paginated email list with cached counts and classification status. Supports filtering by category, priority, is_read, is_starred, and full-text search.

Query params: ?category=work &is_read=false &search=invoice &ordering=-received_at &page=1

{
  "count": 500,
  "next": "...?page=2",
  "results": [ { "id": "uuid", "subject": "...", "category": "work", ... } ],
  "total_emails": 500,
  "unread_count": 45,
  "needs_reply_count": 12,
  "starred_count": 8,
  "category_counts": { "work": 30, "personal": 20, "newsletters": 15 },
  "classification": {
    "total_classified": 450,
    "remaining_unclassified": 50,
    "is_classifying": false,
    "classify_limit": 500,
    "ai_classifications_remaining": 3994,
    "hit_limit": false,
    "plan": "pro"
  }
}

Returns full email detail. On first access: lazy-loads body from provider, auto-marks as read, and classifies old unclassified emails on-demand via AI.

Update read/starred/archived/deleted status. Changes are synced to the email provider (Gmail/Outlook).

{ "is_read": true, "is_starred": false }

Apply actions to multiple emails at once. All changes sync to provider.

// Actions: read, unread, star, unstar, archive, delete
{ "ids": ["uuid1", "uuid2"], "action": "read" }

Returns sync/classification status for all connected accounts. Frontend can poll this.

[{
  "account_id": "uuid",
  "email": "user@gmail.com",
  "is_syncing": false,
  "is_classifying": true,
  "last_synced_at": "2026-04-14T10:30:00Z",
  "total_emails": 500,
  "unread_count": 45,
  "unclassified_count": 12
}]

Re-run AI classification on unclassified emails. Respects the subscription's monthly AI limit.

// Optional body
{ "account_id": "uuid", "limit": 100 }

Returns 3 AI-generated reply suggestions (short, detailed, action). Available on all plans.

// GET /emails/{id}/smart-reply/?tone=professional
{
  "email_id": "uuid",
  "subject": "Project Update",
  "sender": "boss@company.com",
  "suggestions": [
    { "type": "short", "text": "Thanks for the update..." },
    { "type": "detailed", "text": "Thank you for sharing..." },
    { "type": "action", "text": "I'll review the report..." }
  ]
}

{
  "account_id": "uuid",
  "to": ["recipient@example.com"],
  "cc": ["cc@example.com"],
  "subject": "Hello",
  "body_html": "<p>Hello world</p>",
  "body_text": "Hello world"
}

{ "body_html": "<p>Thanks!</p>" }

{ "body_html": "<p>Noted, thanks all!</p>" }

{ "to": ["forward@example.com"], "body_html": "FYI..." }

Pass ?state=JWT_TOKEN so the callback identifies the user.

Google redirects here. Exchanges code for tokens, creates EmailAccount, returns a styled HTML page with success/error state and auto-close countdown.

Same pattern as Gmail connect.

Microsoft redirects here. Same flow as Gmail callback.

Starts a background thread that syncs emails then triggers AI classification on new unread emails.

Same as Gmail sync, routes through provider_service dispatch layer.

Returns all active EmailAccount objects with cached counts and sync status.

Hard-deletes the account and all its emails.

Returns all 4 plans with features, limits, and pricing. No auth required.

Returns the user's current subscription with usage tracking. Auto-creates Free if none exists.

{
  "id": "uuid",
  "plan": { "name": "pro", "max_ai_classifications_per_month": 5000, ... },
  "status": "active",
  "billing_cycle": "monthly",
  "ai_classifications_used": 1006,
  "ai_classifications_limit": 5000,
  "ai_classifications_remaining": 3994,
  "can_connect_account": true
}

{ "plan": "pro", "billing_cycle": "yearly" }

Resets AI usage on upgrade. Checks lifetime plan cap (1000 slots).

Cancels current subscription and downgrades to Free plan.

{ "total_emails": 500, "unread": 45, "ai_sorted": 450,
  "action_required": 12, "by_category": {...}, "recent_unread_7d": 30 }

Deep analysis including: category breakdown, priority distribution, productivity metrics, time-saved estimates, weekly trends, top senders, daily activity heatmap, and peak hours.

Query param: ?days=30 (default 30)

Returns non-dismissed AI insights (tips, alerts, summaries).

Marks the insight as dismissed so it no longer appears.