Send email from your app

​

Recommended integration

import { createMeridianApp } from "@the-meridian/sdk/server"

const meridian = createMeridianApp()

// Best-effort: null on failure, never throws into your request handler.
await meridian.sendEmail({
  shop: session.shop,
  emailId: "template-uuid",
  to: "owner@store.com",
  variables: { name: "Ada" },
  idempotencyKey: "welcome-123",
})

​

Shop context vs app context

​

How this differs from automations

​

Setup

1. Create and activate an email template in the Meridian dashboard.
2. Copy the template UUID.
3. Call sendEmail from your app backend (never from the browser, because the shop token and API key are secrets).

​

Examples

​

Shop context (merchant billing)

import { createMeridianServerClient } from "@the-meridian/sdk/server"

const client = createMeridianServerClient(shopToken)
await client.sendEmail({
  emailId: "template-uuid",
  to: "owner@store.com",
  variables: { name: "Ada" },
  idempotencyKey: "welcome-123",
})

​

App context (platform quota only)

import { createMeridianAdminClient } from "@the-meridian/sdk/server"

const admin = createMeridianAdminClient({ appId, apiKey })
await admin.sendEmail({
  emailId: "template-uuid",
  to: ["ops@example.com"],
})

​

Reliability

• Idempotency: Pass idempotencyKey on sends you may retry (webhook handlers, job queues). Retries with the same key, template, and recipient return the original send row instead of dispatching again. Reusing a key for a different template returns IDEMPOTENCY_KEY_CONFLICT.
• All-or-nothing per request: If any recipient in a batch fails at SendGrid, the API returns an error. Quota for failed units is released automatically.
• Rate limit: 60 requests/minute per app.

​

Limits and errors

• Up to 20 recipients per request.
• Inactive templates are rejected (422).
• Over-quota sends return USAGE_LIMIT_EXCEEDED (409).
• Platform capacity guard returns SENDGRID_CAPACITY_EXHAUSTED (503).