Wolfeo Developers

# Wolfeo API — Introduction

Welcome to the Wolfeo API. Use it to connect Wolfeo to your own apps, automate workflows, and build integrations with tools like Zapier, Make, or your own backend.

# What you can do

  • Manage contacts — create, update, tag, and remove contacts from your account
  • Automate sequences — subscribe or unsubscribe contacts from email sequences
  • Read sales data — query orders, subscriptions, and revenue totals
  • React to events — receive real-time webhook notifications when something happens in Wolfeo

# Base URL

All API endpoints are under:

https://api.wolfeo.me/v1/

# Your first request

Once you have an API key (Settings → API in your Wolfeo account), verify it works:

curl --request GET "https://api.wolfeo.me/v1/api" \
  --header "Authorization: Bearer YOUR_API_KEY"

{
    "success": true,
    "data": {
        "email": "you@example.com"
    }
}

# Response format

Every response uses the same envelope. Always check success before reading data.

Single object

{
    "success": true,
    "data": { }
}

Paginated list

{
    "success": true,
    "data": [ ],
    "meta": {
        "current_page": 1,
        "last_page": 5,
        "per_page": 50,
        "total": 247
    }
}

Error

{
    "success": false,
    "error": {
        "code": "ERROR_CODE",
        "message": "Human-readable description"
    }
}

# Rate limits

The API allows 600 requests per minute (≈ 10 requests per second). If you exceed this, you'll receive a 429 Too Many Requests response. Implement an exponential back-off or request queue on your side.

TIP

API keys require a paid Wolfeo account. Free trial accounts cannot generate keys.

# What's next

Authentication →