Docs / Getting started

Get started with OctoAPP

Everything you need to connect, automate and build on top of OctoAPP via the API and webhooks.

1
Get your API key

In Settings → Integrations → API Keys, create a new production key.

2
Make your first request

Use the token in the Authorization header to create your first task.

3
Receive events

Register a webhook to receive real-time task and approval updates.

# Create a task via the API
POST /api/v1/tasks
Authorization: Bearer oct_live_••••

Browse the guide

Step-by-step articles for every part of OctoAPP.

Setup

Create your workspace

Set up your agency, invite the team and choose your language.

4 min read
Setup

Import your clients

Bring clients and contacts in from a spreadsheet in minutes.

6 min read
Ads AI

Connect ad accounts

Link Meta, Google and TikTok and review your first AI proposals.

8 min read
Finance

Send your first invoice

Create an invoice, add a payment link and track it to paid.

5 min read
API

Authenticate with the API

Create an API key and make your first authenticated request.

10 min read
API

Receive webhooks

Subscribe to events and verify signatures on your server.

7 min read