← All articles
Developer API, MCP and webhooks·

Set up Getwello with Discord

Mirror to a Discord channel. Plain webhook for raw text, middleman for proper embeds.

This guide pipes Getwello check-ins into a Discord channel via webhooks. Plain text works in 30 seconds; rich embeds need a small reshape step.

What you need

  • A Discord server you control.
  • A Getwello Coordinator account with active subscription.

Step 1: Create a Discord webhook

  1. In Discord, click the channel name at the top → Edit Channel → Integrations.
  2. Webhooks → New Webhook. Name it “Getwello”.
  3. Copy the Webhook URL.

Step 2: Mint a Getwello API key

Settings → Developer API → Create. Name it “Discord”.

Step 3: Create the Getwello webhook subscription

Settings → Developer API → Webhooks. URL is your Discord webhook URL. Tick the events you want.

Step 4 (optional): Reshape into a rich embed

Raw text works but is ugly. For a proper Discord embed, route through Zapier, n8n or a Cloudflare Worker. Here's a minimal Worker that takes our event and posts a Discord embed:

export default {
  async fetch(req, env) {
    const evt = await req.json();
    const colour = evt.event === 'check_in.created' ? 2280535 : 15214149;
    await fetch(env.DISCORD_WEBHOOK, {
      method: 'POST',
      headers: { 'content-type': 'application/json' },
      body: JSON.stringify({
        username: 'Getwello',
        embeds: [{
          title: evt.event === 'check_in.created'
            ? 'Mum has just checked in'
            : 'Mum missed her check-in',
          color: colour,
          fields: [
            { name: 'Time', value: evt.occurred_at, inline: true },
            { name: 'Mood', value: evt.data.mood ?? 'n/a', inline: true }
          ]
        }]
      })
    });
    return new Response('ok');
  }
};

Test

Click Test on the Getwello side. Discord shows the message within a couple of seconds. If it doesn't, double-check the webhook URL.

Troubleshooting

Message looks broken: raw event JSON in Discord is ugly. Add the reshape step above.

Discord rate-limits us: Discord webhooks accept 30 requests/minute per channel. Family Circles never get close to this.

More on developer api, mcp and webhooks

Didn't answer your question?

Email hello@getwello.co.uk