Getting Started with Mailoo

Last updated: Sep 13, 2026Section: Getting Started

Mailoo helps you run website forms, subscriber lists, a headless blog, a market catalog, social publishing, and a JSBOX chat widget from one dashboard. You connect your product through server-side webhooks and API keys---Mailoo is not a mailbox connector.

What You'll Need

  • A Mailoo account through your configured identity provider
  • A dashboard project that will own integrations and API keys
  • Server-side or BFF capacity to store X-API-Key secrets safely

Step 1: Create Your Account and Project

  1. Visit https://mailoo.app and choose Get started (or Sign in).

  2. Complete authentication with your identity provider (IdP). There is no separate registration form inside the Mailoo dashboard: Sign in / Get started opens the IdP. Login, registration, password reset, and email verification all happen on Mailoo-branded IdP pages. Locales match the site (English, German, Spanish, Russian). Light and dark appearance follow the theme you use on mailoo.app.

  3. Create a project from the dashboard and note its projectUid.

    Project owners can invite collaborators as OWNER or EDITOR (optional per-integration editor scope). Invited members sign in and accept the invite link.

Step 2: Add Your First Integration

  1. Open Integrations inside the project (or choose Add integration).
  2. Pick the type that matches your surface area:
  • FORM --- newsletter or lead capture
  • CONTACT_FORM --- support or feedback messages
  • JSBOX --- embeddable realtime chat
  • BLOG --- editorial content via the public blog API
  • MARKET --- product catalog, orders, and offer generators
  • SOCIAL --- posts to X and Facebook
  1. Finish the configuration wizard (optional allowed origins, display names, and type-specific connection settings).

Step 3: Connect Your Application

  • Forms: call Mailoo from your server or BFF with a scoped API key held in environment variables. Prefer the @mailoo/forms BFF helpers for Next.js.
  • Chat: embed the JSBOX widget (or @mailoo/chat), pass the project and integration identifiers, and use the dashboard chat console for operators.
  • Blog / Market: publish in the dashboard, then read from your site via the external APIs with X-API-Key.
  • Social: add channel credentials under Connection & settings, then compose and publish posts in the dashboard.
  • Agents (optional): create an MCP agent token under Profile → Security → MCP tokens and point your MCP host at https://mcp.mailoo.app/mcp. See integrations/mailoo-mcp{.interpreted-text role="doc"}.

Step 4: Verify Messages and Subscribers

  1. Trigger a test submission from a safe environment.
  2. Confirm the row appears under Messages with the expected metadata.
  3. For FORM integrations, verify Subscribers captured the test email.

Optional: Outbound SMTP

Subscriber-facing mail (replies, welcome sequences, transactional send, market order confirmations) uses SMTP credentials stored on the integration. There is no silent fallback to a shared platform mailer---configure SMTP before relying on those features. See integrations/outbound-smtp{.interpreted-text role="doc"}.

Next Steps

  • quick-setup{.interpreted-text role="doc"} --- checklist for a fast production pass
  • Integration guides under Integrations
  • OpenAPI schemas at https://api.mailoo.app/docs/v1
📚