Create your first API key

An API key is the password your integration uses to talk to Getwello. Without it, nothing works. With it, your integration can do anything you can do as a Coordinator.

Before you start

• You must be signed in as a Coordinator. If you are not, the page below will redirect you back to Settings.
• Your Circle must have an active subscription. Trial counts as active.
• You will see the full key once, at create time. Have somewhere to paste it ready (password manager, your AI assistant's config file, a secure note).

Steps

1. Sign in at getwello.co.uk.
2. Open Settings → Developer API.
3. In the Your API keys section, type a name in the box. Pick something you will recognise later, like "Home Assistant on the home server" or "Claude Desktop on my MacBook". Names help when you have several keys and need to revoke just one.
4. Click Create key.
5. A modal appears showing the key, which starts with gw_live_ followed by 32 random characters.
6. Click Copy token. This is the only time the full key is shown. If you lose it, you cannot get it back, you can only revoke this one and create a new one.
7. Paste the key into your integration's configuration (your Claude Desktop config, your Home Assistant secrets file, an env var, wherever it needs to live).
8. Click I've saved it, close to dismiss the modal.

After you have a key

Your next steps depend on what you are connecting:

• For Claude or any AI: Set up the MCP server with Claude Desktop.
• For Home Assistant, n8n, or any tool that listens to webhooks: Set up your first webhook.
• For direct REST calls: the endpoints are documented at getwello.co.uk/developers.

Revoking a key

If a key has leaked, or you are decommissioning an integration, go back to Settings → Developer API, find the key in the list, and click Revoke. It stops working immediately. The revoked key stays in your list (so the audit trail is intact) but no longer authenticates.

How many keys can I have?

As many as you want. Most people end up with one or two. Mint a separate key for each distinct integration; that way, if your home server is compromised, you only revoke that one and your Claude Desktop integration keeps working.