Get your API key
All integrations Support

Help Scout + MailKite

Help Scout is a customer support platform. Use MailKite to receive inbound email as Help Scout conversations — every email becomes a trackable conversation.

What you need

Send email

Use MailKite SMTP for transactional outbound. Help Scout handles replies within its conversation system.

smtp-config
SMTP Host: smtp.mailkite.dev
SMTP Port: 587
SMTP Username: mailkite
SMTP Password: mk_live_...
From: hello@yourdomain.com

Receive inbound email (optional)

Point your domain's webhook to this handler. Each inbound email becomes a Help Scout conversation.

handle-inbound.ts
// Receive inbound email → create Help Scout conversation
const HELPSCOUT_API = 'https://api.helpscout.net/v2';

async function handleInbound(email) {
// Create or get customer
const customerRes = await fetch(`${HELPSCOUT_API}/customers`, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
Authorization: `Bearer ${process.env.HELPSCOUT_API_KEY}`,
},
body: JSON.stringify({ email: email.from }),
});
const customer = await customerRes.json();

// Create conversation
const convRes = await fetch(`${HELPSCOUT_API}/conversations`, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
Authorization: `Bearer ${process.env.HELPSCOUT_API_KEY}`,
},
body: JSON.stringify({
mailboxId: parseInt(process.env.HELPSCOUT_MAILBOX_ID),
subject: email.subject || 'Inbound email',
type: 'customer',
customer: { id: customer.id },
text: email.text,
}),
});
return convRes.json();
}

Test it

terminal
curl -X POST https://your-worker.example.com/mailkite-inbound \
-H "Content-Type: application/json" \
-d '{"from":"customer@example.com","to":"support@yourdomain.com","subject":"Question","text":"How do I upgrade?"}'

Troubleshooting

  • Help Scout requires a mailboxId. Get it from Help Scout → Mailboxes → Settings.
  • Create a Help Scout API key under Manage → Apps → API Keys.
  • Ensure the mailbox is active and configured for inbound email.

See the SMTP relay docs for the full connection reference, or all integrations for other platforms.