API

Automate Sawirpost with a personal access token. The API is JSON over HTTPS, scoped to a team.

Authentication

Create a token on your Profile page (it's shown once — store it safely). Send it as a Bearer header:

Authorization: Bearer YOUR_TOKEN
Accept: application/json

Tokens act as you: they can reach any team you belong to, with your role's permissions.

Endpoints

All routes live under https://sawirpost.com/api/organizations/{organization}:

GET    /channels          List connected channels
GET    /posts             List posts
POST   /posts             Create a draft or scheduled post
GET    /posts/{post}      Inspect a post and its per-channel status
DELETE /posts/{post}      Delete a post

Creating a post

POST /api/organizations/1/posts
{
    "body": "Shipping day. Details in the reply.",
    "channels": [{"id": 4}, {"id": 7}],
    "scheduled_at": "2026-08-01T09:00:00Z"
}

Omit scheduled_at to create a draft. The response includes the post with a target per channel; poll GET /posts/{post} after the scheduled time to see per-channel results and external post IDs.

For AI agents

/llms.txt summarizes the whole product in one machine-readable page. Two rules: scheduling requires an active trial or subscription, and subscribing always requires a human to complete Stripe checkout.