This documentation URL will be retired soon. Start using the Ranla API at https://api.ranla.ai. Docs: docs.ranla.ai.

SuperSend TX + Replit

Two install surfaces, depending on the job:

Surface Use when
MCP (Agent tools) Replit Agent should call SuperSend TX (send, domains, templates) while building
Secrets + app code Your running repl sends mail (password reset, invites, notifications)

Most projects use both: MCP while building, Secrets for production paths in the app.

Add to Replit (MCP)

One-click install of the hosted MCP server (https://mcp.supersendtx.com/mcp). Replit uses OAuth — no API key in the link.

Install SuperSend TX

Or open: Add SuperSend TX MCP

After install, authorize with your SuperSend TX account when prompted. Full MCP docs: MCP server.

Wire email into your app (Secrets)

1. Add your API key

  1. Create an API key at app.supersendtx.com (stx_…).
  2. In Replit, open ToolsSecrets (or Integrations → secrets, depending on Replit UI).
  3. Create a secret:
Key Value
SUPERSENDTX_API_KEY stx_your_key_here

Replit injects secrets as environment variables. Access via process.env.SUPERSENDTX_API_KEY (Node) or os.environ["SUPERSENDTX_API_KEY"] (Python). Never expose the key to the client.

2. Paste this prompt in Replit Agent

Integrate SuperSend TX transactional email into this Replit project.

Docs:
- https://docs.supersendtx.com/ai/agent-skill
- https://docs.supersendtx.com/openapi.yaml
- https://docs.supersendtx.com/builders/replit
- https://docs.supersendtx.com/ai/mcp

Rules:
1. Read SUPERSENDTX_API_KEY from Replit Secrets (already configured). Never log or expose the key to the client.
2. Send with POST https://api.supersendtx.com/emails and Authorization: Bearer <key>.
3. Until domain verification and Free production unlock (both required: verified domain + payment method on file), use from "[email protected]" and send only to the SuperSend TX account email.
4. Implement server-side email for at least one flow (welcome, reset, or notification).
5. Use html and text fields; prefer supersendtx npm package on Node.

For production: verify a domain, add a payment method to unlock Free production (no charge until you upgrade), then set from to an address on that domain. Upgrade to Pro or Scale for more volume.

3. Minimal Express route (Node)

import express from 'express'

const app = express()
app.use(express.json())

app.post('/api/send-test', async (req, res) => {
  const apiKey = process.env.SUPERSENDTX_API_KEY
  if (!apiKey) return res.status(500).json({ error: 'Missing SUPERSENDTX_API_KEY' })

  const upstream = await fetch('https://api.supersendtx.com/emails', {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${apiKey}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify(req.body),
  })

  const data = await upstream.json()
  res.status(upstream.status).json(data)
})

Sandbox self-test

Send to your SuperSend TX account email only, with from: "[email protected]", until your domain is verified and Free production is unlocked (payment method on file).

Production

  1. Verify a sending domain in SuperSend TX.
  2. Add a payment method to unlock Free production (no charge until you upgrade), or upgrade for higher volume.
  3. Set from to [email protected] (or similar on your verified domain).