Introduction

Welcome to the Hatrio Automation API. This API provides programmatic access exclusively for Hatrio Hub users. You can connect your workspace to external tools like n8n or Zapier, automate content generation, and subscribe to real-time events.

Integration Overview

The Hatrio API is designed to work seamlessly with your existing Hatrio Hub website. It consists of two main integration patterns:

Inbound API

Command your workspace from custom backends. You can programmatically fetch leads, generate new articles, or analyze brand DNA.

Outbound Webhooks

Register webhook endpoints in the dashboard to have Hatrio automatically push JSON payloads to your servers whenever an event occurs.

Architecture & Security

Best practices for securing your integration and understanding how data flows:

  • Bearer Tokens: All API requests must include your Platform Key in the Authorization header. Keep your keys secure and rotate them if compromised.
  • Shared Database: The API interacts directly with your Hatrio Hub database. Any changes made via the API will instantly reflect in your main dashboard.
  • Identity-Aware: Every content generation request is grounded in your website's active Brand DNA profile.

Base URL

All API requests should be made to the following base URL:

https://api.hatrio.ai/api/v1

Note: We recommend using the hat_live_ keys for production environments.