REST API

Call the ingest endpoint directly from any language — Python, PHP, Go, Ruby, or anything that can make an HTTP request.

Base URL

https://api.logit.now

Authentication

Pass your API key as a Bearer token in the Authorization header.

POST /api/ingest

Ingest a single event into a channel.

bash

curl -X POST https://api.logit.now/api/ingest \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "channel": "signups",
    "event": "New user signed up",
    "description": "alex@example.com just joined",
    "icon": "👤",
    "notify": true,
    "tags": { "plan": "pro" },
    "metadata": { "email": "alex@example.com" }
  }'

Python example:

python

import httpx

httpx.post(
    "https://api.logit.now/api/ingest",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "channel": "payments",
        "event": "Payment received",
        "icon": "💳",
        "notify": True,
        "tags": {"plan": "starter"},
        "metadata": {"amount": 49, "email": "user@example.com"},
    },
)

Request body

Field	Type	Required	Description
`channel`	`string`	Yes	Channel to log the event into
`event`	`string`	Yes	Short human-readable title
`description`	`string`	No	One-line context string
`icon`	`string`	No	Emoji shown in the inbox
`notify`	`boolean`	No	Send a push notification (default: false)
`tags`	`object`	No	Key-value pairs for filtering
`metadata`	`object`	No	Arbitrary JSON object
`trackingId`	`string`	No	First event's `id` — links events into a timeline
`inbox`	`boolean`	No	Show in realtime inbox (default: true)
`projectId`	`string`	No	Project ID (inferred from token if omitted)

Response

json

{ "success": true, "id": "evt_abc123", "trackingId": "evt_abc123" }

On the first event in a timeline, id and trackingId are equal. Pass this id as trackingId in subsequent events to group them.

Error codes

Status	Meaning
`400`	Missing required fields or malformed JSON
`401`	Missing or invalid API key
`404`	Project not found for this API key
`429`	Rate limit exceeded
`500`	Internal server error