Developer API

Build with InviteWaale

Create digital invites, manage RSVPs, and send reminders — all from ChatGPT, Claude, Zapier, or your own code. One API key. Four endpoints. That's it.

Get Your API Key OpenAPI Spec

Up and running in 3 steps

🔑

Get an API key

Generate key →

📡

Make your first call

Send a POST to /api/ai/create-event with your key in the Authorization header

See endpoints →

🎉

Share the invite

Get back an invite_url and rsvp_url — share them via WhatsApp, email, or embed

Code examples →

Authentication

All API requests require a Bearer token in the Authorization header:

Headerbash

Authorization: Bearer iwk_your_api_key_here

API Key (recommended)

✓ Long-lived, no expiry hassles
✓ Works with any HTTP client
✓ Starts with iwk_
✓ Revocable from dashboard

Supabase JWT (advanced)

○ Short-lived (~1 hr)
○ Requires Supabase Auth session
○ Best for browser-based integrations
○ Auto-detected (no prefix needed)

API Endpoints

Base URL: https://invitewaale.com

Create a new invite event

Creates a new event with a public invite page and RSVP link. The event is published immediately and ready to share.

Rate limit: 10 req/min

Request Bodyjson

{
  "title": "Aarav's 5th Birthday Party",
  "host_name": "Priya Sharma",
  "event_date": "2026-04-15",
  "event_time": "4:00 PM - 7:00 PM",
  "location": "Funana Play Center, Bangalore",
  "description": "Join us for fun, games, and cake! 🎂"
}

Responsejson

{
  "success": true,
  "event_id": "a1b2c3d4-...",
  "invite_url": "https://invitewaale.com/invites/aaravs-5th-birthday",
  "rsvp_url": "https://invitewaale.com/rsvp/aaravs-5th-birthday"
}

Code Examples

Create an invite — cURLcurl

curl -X POST https://invitewaale.com/api/ai/create-event \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer iwk_YOUR_KEY_HERE" \
  -d '{
    "title": "Aarav 5th Birthday Party",
    "host_name": "Priya Sharma",
    "event_date": "2026-04-15",
    "event_time": "4:00 PM - 7:00 PM",
    "location": "Funana Play Center, Bangalore",
    "description": "Join us for fun, games, and cake! 🎂"
  }'

AI Assistant Guides

ChatGPT — Custom GPT (best experience)

Natural conversation, auto-calls the API

1Go to chatgpt.com/gpts/editor → Create a new GPT
2In Configure → Instructions, paste: "You help users create digital invitations using the InviteWaale API. Ask for event title, host name, date, time, location, and description, then call create-event."
3Scroll to Actions → click "Import from URL" → enter: https://invitewaale.com/openapi.json
4Set Authentication → API Key → Auth Type: Bearer → paste your iwk_... key
5Save → Now just say: "Create a birthday invite for Misha on April 20th"

ChatGPT — Code Interpreter (quick)

ChatGPT Plus only — runs Python directly

Paste this prompt in ChatGPT (with Code Interpreter enabled):

Prompt for ChatGPT Code Interpreterpython

Run this Python code to create my invite:

import requests

response = requests.post(
    "https://invitewaale.com/api/ai/create-event",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer iwk_YOUR_KEY_HERE"
    },
    json={
        "title": "Aarav's 5th Birthday",
        "host_name": "Priya Sharma",
        "event_date": "2026-04-15",
        "event_time": "4:00 PM",
        "location": "Funana Play Center, Bangalore",
        "description": "Come celebrate with us! 🎂🎈"
    }
)

print(response.json())

Claude, Gemini & Other AI Assistants

Any AI that can run code or make HTTP requests

Use the same Python/cURL code from the examples above. Most AI assistants with code execution can make the HTTP call. Simply paste the code and replace iwk_YOUR_KEY_HERE with your actual key.

MCP Server — Claude, Cursor & AI IDEs

Native integration via Model Context Protocol ✨

NEW

InviteWaale exposes a Model Context Protocol (MCP) server so AI assistants can create invites, manage RSVPs, and send reminders as native tools — no copy-pasting code.

🖥️ Claude Desktop

Claude Desktop uses stdio transport and cannot connect directly to a remote HTTP MCP server. You need our lightweight proxy script — it has zero npm dependencies (pure Node.js).

1.Download mcp-proxy.js and save it somewhere permanent (e.g. ~/invitewaale-mcp-proxy.js)
2.Add this to claude_desktop_config.json:

claude_desktop_config.jsonjson

{
  "mcpServers": {
    "invitewaale": {
      "command": "node",
      "args": ["/full/path/to/mcp-proxy.js"],
      "env": {
        "INVITEWAALE_API_KEY": "iwk_YOUR_KEY_HERE"
      }
    }
  }
}

💡 On Windows use double backslashes: C:\\\\Users\\\\you\\\\mcp-proxy.js

💻 Cursor, Windsurf & VS Code (GitHub Copilot)

These AI IDEs support remote HTTP MCP servers natively — no proxy needed. Just point them at the URL directly.

mcp.json / .cursor/mcp.jsonjson

{
  "mcpServers": {
    "invitewaale": {
      "url": "https://invitewaale.com/api/mcp",
      "headers": {
        "Authorization": "Bearer iwk_YOUR_KEY_HERE"
      }
    }
  }
}

🌐 claude.ai (Web)

1.Go to claude.ai → Settings → Integrations
2.Click "Add MCP Server"
3.Server URL: https://invitewaale.com/api/mcp
4.Authorization header: Bearer iwk_YOUR_KEY_HERE

Available tools: create_invite, create_rsvp_form, get_event_summary, send_reminders

Zapier, Make (Integromat) & n8n

Automate invite creation from any trigger

1.Add a "Webhook / HTTP Request" action
2.Method: POST • URL: https://invitewaale.com/api/ai/create-event
3.Headers: Authorization: Bearer iwk_... and Content-Type: application/json
4.Body: JSON with title, host_name, event_date, etc.

Error Codes & Rate Limits

Status	Meaning	What to do
`200`	Success	Parse the JSON response body
`201`	Created (API keys)	Save the plaintext key immediately
`400`	Validation error	Check required fields: title, host_name, event_date
`401`	Unauthorized	Check your API key is correct and not revoked
`404`	Not found	Check the event_id UUID is valid
`429`	Rate limited	Wait 60 seconds and retry
`500`	Server error	Retry after a moment; contact support if persistent

⏱️ Rate Limits

create-event: 10 requests/minute

create-rsvp-form: 10 requests/minute

event-summary: 30 requests/minute

send-reminders: 3 requests/minute

Rate limits are per-IP. If you hit a 429, wait 60 seconds and retry.

🚀

Ready to build?

Get your API key, create your first invite in under a minute, and let AI handle the rest.

Get Your API Key Go to Dashboard