Self-hosted email delivery platform that enables applications to send emails via HTTP APIs while handling SMTP delivery, templates, storage, security, and analytics. Fully self-hostable alternative to services like SendGrid or Mailgun.
Go email-relayemail-routinghttp-to-smtpmail-deliverymailchimp-alternativemailgun-alternativemailsendermailservermailtemplatemailtestpostmark-alternativesend-emailsendgrid-alternativesendmailtransactional-emailtransactional-outbox
import api from './client'
import type {
ApiResponse,
PaginatedResponse,
Template,
TemplateListItem,
TemplateInput,
TemplateExport,
TemplatePreview,
TemplateVersion,
TemplateVersionInput,
TemplateLocalization,
TemplateLocalizationInput,
SendTestInput,
SendTestResponse,
} from './types'
export const templatesApi = {
list(page = 0, size = 20, search = '') {
return api.get<PaginatedResponse<TemplateListItem>>('/workspaces/current/templates', { params: { page, size, search } })
},
get(id: number) {
return api.get<ApiResponse<Template>>(`/workspaces/current/templates/${id}`)
},
create(data: TemplateInput) {
return api.post<ApiResponse<Template>>('/workspaces/current/templates', data)
},
update(id: number, data: Partial<TemplateInput>) {
return api.put<ApiResponse<Template>>(`/workspaces/current/templates/${id}`, data)
},
delete(id: number) {
return api.delete(`/workspaces/current/templates/${id}`)
},
// Versions
listVersions(templateId: number) {
return api.get<ApiResponse<TemplateVersion[]>>(`/workspaces/current/templates/${templateId}/versions`)
},
createVersion(templateId: number, data: TemplateVersionInput) {
return api.post<ApiResponse<TemplateVersion>>(`/workspaces/current/templates/${templateId}/versions`, data)
},
updateVersion(templateId: number, versionId: number, data: Partial<TemplateVersionInput>) {
return api.put<ApiResponse<TemplateVersion>>(`/workspaces/current/templates/${templateId}/versions/${versionId}`, data)
},
activateVersion(templateId: number, versionId: number) {
return api.post<ApiResponse<Template>>(`/workspaces/current/templates/${templateId}/activate/${versionId}`)
},
deleteVersion(templateId: number, versionId: number) {
return api.delete(`/workspaces/current/templates/${templateId}/versions/${versionId}`)
},
// Localizations
listLocalizations(templateId: number, versionId: number) {
return api.get<ApiResponse<TemplateLocalization[]>>(`/workspaces/current/templates/${templateId}/versions/${versionId}/localizations`)
},
createLocalization(templateId: number, versionId: number, data: TemplateLocalizationInput) {
return api.post<ApiResponse<TemplateLocalization>>(`/workspaces/current/templates/${templateId}/versions/${versionId}/localizations`, data)
},
updateLocalization(localizationId: number, data: Partial<Omit<TemplateLocalizationInput, 'language'>>) {
return api.put<ApiResponse<TemplateLocalization>>(`/workspaces/current/localizations/${localizationId}`, data)
},
deleteLocalization(localizationId: number) {
return api.delete(`/workspaces/current/localizations/${localizationId}`)
},
previewLocalization(templateId: number, versionId: number, data: { language: string; template_data: Record<string, any> }) {
return api.post<ApiResponse<TemplatePreview>>(`/workspaces/current/templates/${templateId}/versions/${versionId}/preview`, data)
},
// Renders raw, unsaved template content so the editor can show a live preview
// without persisting first.
previewTemplate(data: {
subject_template: string
html_template?: string
text_template?: string
stylesheet_id?: number | null
template_data?: Record<string, any>
}) {
return api.post<ApiResponse<TemplatePreview>>('/workspaces/current/templates/preview', data)
},
sendTest(templateId: number, data: SendTestInput) {
return api.post<ApiResponse<SendTestResponse>>(`/workspaces/current/templates/${templateId}/send-test`, data)
},
// Import/Export
exportTemplate(templateId: number) {
return api.get<ApiResponse<TemplateExport>>(`/workspaces/current/templates/${templateId}/export`)
},
importTemplate(data: TemplateExport) {
return api.post<ApiResponse<Template>>('/workspaces/current/templates/import', data)
},
importHTML(file: File) {
const formData = new FormData()
formData.append('file', file)
return api.post<ApiResponse<Template>>('/workspaces/current/templates/import-html', formData, {
headers: { 'Content-Type': 'multipart/form-data' },
})
},
}