API

Kovcheg Post API is designed for product teams, Make and n8n automations, CRM systems, internal dashboards and Telegram bot workflows. It accepts user-approved media, captions and target platforms, then routes the publication through connected accounts.

Publishing flow

A customer connects accounts through OAuth. Your system sends a publishing request to Kovcheg Post. The backend verifies account ownership, adds the item to a queue, calls official platform APIs and returns delivery status.

POST /api/v1/publish
Authorization: Bearer YOUR_TOKEN

{
  "client_id": "client_123",
  "caption": "New product update",
  "media_url": "https://example.com/photo.jpg",
  "targets": ["instagram", "facebook", "threads"]
}

Webhook events

• publish.created – a publication was added to the queue.
• publish.done – a publication was completed.
• publish.failed – a connected platform returned an error.
• account.reconnect_required – the customer must reconnect the platform account.
• message.received – a supported incoming message was received after permissions are approved.