API Documentation

Integrate MakewishAI into your applications with our powerful RESTful API.

API Features

RESTful API

Clean, predictable REST endpoints with JSON responses

Secure Authentication

OAuth 2.0 and API key authentication methods

Rate Limiting

1000 requests per hour on free tier, unlimited on enterprise

Detailed Documentation

Comprehensive guides with code examples in multiple languages

Quick Start

Authentication

All API requests require authentication using your API key. Include it in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Example Request

Create a personalized wish using the AI generation endpoint:

curl -X POST https://api.makewishai.com/v1/wishes \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": {
      "name": "John Doe",
      "email": "john@example.com"
    },
    "occasion": "birthday",
    "tone": "friendly",
    "length": "medium"
  }'

API Endpoints

POST/api/v1/wishes

Create and send a personalized wish

GET/api/v1/wishes

Retrieve all wishes for your account

GET/api/v1/wishes/{id}

Get details of a specific wish

POST/api/v1/contacts

Add a new contact to your account

GET/api/v1/contacts

List all contacts with pagination

PUT/api/v1/contacts/{id}

Update contact information

DELETE/api/v1/contacts/{id}

Remove a contact from your account

POST/api/v1/ai/generate

Generate AI-powered wish content

SDKs & Libraries

Ready to Start Building?

Get your API key and start integrating MakewishAI into your applications today.

Get API Key Contact Sales