Developers

Build onthe Mateflow API.

Build on the Mateflow Open API — scoped API keys, JSON-over-POST endpoints, and webhooks to integrate your community with your stack.

Capabilities

Everything you need to integrate

API key authentication

Create scoped API keys in your community's admin console. Every request is authenticated with the X-API-Key header.

REST API

Read and write your community's data through a consistent JSON API. Every endpoint lives under /site_open_api/v1 and uses POST with a JSON body.

Webhooks

Configure webhook endpoints to receive real-time event notifications for member signups, payments, content changes, and more.

Integrations

Connect third-party tools through the integrations hub. Built-in support for common workflows and an app catalog for extending functionality.

SSO (SAML & OIDC)

Enterprise SSO with SAML 2.0 and OpenID Connect. Centralize authentication for your team and community members.

Webhook logs & monitoring

Full delivery logs for every webhook event. Debug failed deliveries, inspect payloads, and monitor integration health.

Open API endpoints

All endpoints live under https://api.mateflow.com/site_open_api/v1, use the POST method with a JSON body, and require an API key with the listed scope.

BASE URLhttps://api.mateflow.com/site_open_api/v1

POST/site/getsite.readGet site info
POST/feed/listcontent.readList feed items
POST/post/searchcontent.readSearch posts
POST/post/createcontent.writeCreate a post
POST/media/get_tokenmedia.writeGet a media upload token

Quick start

Get started in three steps

Step 01

Create an account

Step 02

Generate API keys

Enable API access in your community's admin console (Settings → Integrations) and create a scoped key. Available on Growth, Business, and Enterprise plans.

Step 03

Make your first call

Send your first request with the X-API-Key header. All endpoints accept JSON POST requests.

Start making API calls

Quick examples in the most common languages. Replace sk_live_xxx with a real key from your admin console.

cURL

curl -X POST \
  https://api.mateflow.com/site_open_api/v1/post/search \
  -H "X-API-Key: sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "hello", "limit": 20}'

JavaScript

const res = await fetch(
  "https://api.mateflow.com/site_open_api/v1/post/create",
  {
    method: "POST",
    headers: {
      "X-API-Key": "sk_live_xxx",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ title: "Hello", content: "From the API!" }),
  }
);
const data = await res.json();

Python

import requests

res = requests.post(
    "https://api.mateflow.com/site_open_api/v1/site/get",
    headers={"X-API-Key": "sk_live_xxx"},
    json={},
)
data = res.json()

SDK roadmap

Official SDKs for Node.js, Python, and Go are on the roadmap. Until then, the REST API works with any HTTP client. Full API documentation is coming soon.

Ready to build?

Create an account, generate your API keys, and start integrating the Mateflow platform into your workflows.

Start free trial Contact engineering

14-day free trial · No credit card required