Logs.so API Docs

Send logs to your workspace with a simple HTTP API or npm package.

API Endpoint

POST https://api.logs.so/v2/log

Headers:

Content-Type: application/json
Authorization: <your-api-key>

Body fields:

project* (string) - Your workspace/project ID
channel* (string) - Channel name for the log
event* (string) - Event title
description (string) - Event description
icon (string) - Single emoji character
notify (boolean) - Send notification (default: false)
tags (object) - Custom tags (object)
parser (string) - Parser type [MARKDOWN, TEXT]
user_id (string) - User ID
timestamp (number) - Unix timestamp (seconds)
keywords (array) - Keywords for search (array)

Example: cURL

curl -X POST https://api.logs.so/v2/log   -H "Content-Type: application/json"   -H "Authorization: your-api-key-here"   -d '{
    "project": "my-project",
    "channel": "api-logs",
    "event": "User Registration",
    "description": "New user registered successfully",
    "tags": {"user": "123"},
    "notify": false,
    "timestamp": 1735123456
  }'

Example: npm package

import Logs from "logs.so";

const logs = new Logs({
  apiKey: "your-api-key-here",
  project: "my-project"
});

await logs.track({
  channel: "api-logs",
  event: "User Registration",
  description: "New user registered successfully",
  tags: { user: "123" },
  notify: false,
  timestamp: 1735123456
});

* Required fields