Settings | ThoughtfulOS

API Key

Use this key in the x-api-key header when sending webhooks.

Loading...

Webhook Endpoint

Send events from Thoughtful.app to this URL. Requires x-api-key header.

Endpoint URL

--

Accepted Events

user.signup → New user registered

user.activated → User activated account

user.converted → User upgraded to paid

session.started → User session began

Example Request

// Send a signup event via webhook
curl -X POST "https://thoughtfulos.polsia.app/api/webhooks/thoughtful" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "event": "user.signup",
    "email": "user@example.com",
    "metadata": {
      "source": "organic",
      "plan": "free"
    }
  }'

Client-Side Tracking

Embed this snippet in Thoughtful.app to track events without server-side integration. CORS-enabled, no API key required.

Tracking Endpoint

--

JavaScript Snippet

// ThoughtfulOS Tracking — paste in your app
const TOS = {
  endpoint: "https://thoughtfulos.polsia.app/api/track",

  track(event, data = {}) {
    return fetch(this.endpoint, {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({
        event,
        email: data.email || null,
        source: data.source || null,
        metadata: data.metadata || {}
      })
    }).catch(() => {}); // Fire-and-forget
  }
};

// Usage examples:
TOS.track("user.signup", {
  email: "user@example.com",
  source: "organic"
});

TOS.track("session.started", {
  email: "user@example.com",
  metadata: { page: "/dashboard" }
});