Documentation

Platform Docs

Everything you need to get started with ReachPilot, integrate with our API, and connect your platforms.

Getting Started

Create Your Account

Connect Your First Platform

Link a social media account using OAuth. ReachPilot requests minimal permissions and uses PKCE for secure authorization.

Create and Schedule Content

Use the AI Content Studio to generate platform-optimized posts. Schedule them across timezones or publish immediately.

Review Analytics

Monitor performance across all connected platforms from a single dashboard. Track engagement, reach, and growth trends.

API Overview

Authentication

All API requests require a Bearer token. Generate API keys from your dashboard under Settings > API Keys.

Rate Limits

Free: 100 requests/hour. Pro: 1,000 requests/hour. Agency: 10,000 requests/hour. Rate limit headers are included in every response.

Endpoints

RESTful API with JSON request and response bodies. Base URL: https://api.reachpilot.au/v1. Full OpenAPI spec coming soon.

SDKs

Official TypeScript/JavaScript SDK available. Python and Go SDKs are on the roadmap.

Platform Integrations

Facebook & Instagram

Publish posts, stories, and reels. Requires Facebook Business account. Supports carousel posts and scheduled publishing.

TikTok

Upload videos and manage captions. Supports direct publishing via TikTok Content Posting API.

Publish articles, text posts, and image posts to personal profiles and company pages.

X (Twitter)

Post tweets, threads, and media. Supports the X API v2 with OAuth 2.0 PKCE.

YouTube

Upload videos, manage titles and descriptions, set visibility and scheduling. Requires YouTube channel with API access.

Google Ads

Create and manage ad campaigns. Supports responsive search ads, display ads, and performance tracking.

Create pins with images and descriptions. Supports rich pins and board management.

Snapchat

Manage Snapchat Ads and public stories. Supports creative uploads and audience targeting.

Webhook Documentation

Setting Up Webhooks

Configure webhook endpoints in Settings > Webhooks. Provide an HTTPS URL and select which events to receive.

Event Types

Available events: post.published, post.failed, post.scheduled, analytics.updated, account.connected, account.disconnected.

Payload Format

All webhooks deliver JSON payloads with event type, timestamp (ISO 8601 with timezone), and event-specific data.

Verification

Each webhook includes an X-ReachPilot-Signature header (HMAC-SHA256) for payload verification. Signing secret available in your dashboard.

Timezone Handling

Automatic Detection

ReachPilot detects your timezone using the Intl API on first login. All times in the dashboard display in your local timezone.

Scheduling Across Timezones

Schedule posts for specific times in any timezone. ReachPilot stores schedules with IANA timezone identifiers and handles DST transitions automatically.

Team Timezone Support

Each team member sees times in their own timezone. The content calendar supports timezone overlays to visualize global publishing schedules.

API Timezone Conventions

All API timestamps use ISO 8601 format with timezone offset. You can specify a timezone parameter on scheduling endpoints using IANA timezone names.

Full API docs coming soon

We're building interactive API documentation with request examples and live testing. In the meantime, contact us for API access.