Overview - Corsair

Use Instagram through Corsair: one client, typed API calls, optional local DB sync, and incoming webhooks documented below. What you get:

23 typed API operations
5 database entities synced for fast .search() / .list() queries
3 incoming webhook event types

Setup

Install

pnpm install @corsair-dev/instagram

Add the plugin

Solo
Multi-Tenant

corsair.ts

import { createCorsair } from 'corsair';
import { instagram } from '@corsair-dev/instagram';

export const corsair = createCorsair({
	// ... other config options,
	multiTenancy: false,
    plugins: [instagram()],
});

corsair.ts

import { createCorsair } from 'corsair';
import { instagram } from '@corsair-dev/instagram';

export const corsair = createCorsair({
	// ... other config options,
    multiTenancy: true,
    plugins: [instagram()],
});

See Multi-tenancy for account isolation.

Get credentials

Follow Get Credentials if you need help getting keys.

Store credentials

Solo
Multi-Tenant

pnpm corsair setup --plugin=instagram

Use the key names documented in Get Credentials (for example api_key=, bot_token=, or OAuth client fields).

pnpm corsair setup --plugin=instagram --tenant=<tenantId>

Store per-tenant secrets after you create the tenant record. See Multi-tenancy.

Authentication

Each tab shows how to register the plugin for that authentication method. The default authType from the plugin does not need to appear in the factory call.

OAuth 2.0 (Default)

corsair.ts

instagram()

Store credentials with pnpm corsair setup --plugin=instagram (see Get Credentials for field names). For OAuth, you typically store integration keys at the provider level and tokens per account or tenant.More: OAuth 2.0

Webhooks

This plugin registers 3 webhook handler(s). Configure your provider to POST events to your Corsair HTTP endpoint, then use webhookHooks in the plugin factory for custom logic. See Webhooks for every event path and payload shape, and Webhooks concept for how to set up routing.

Query synced data

Synced entities support corsair.instagram.db.<entity>.search() and .list(). See Database for filters and operators.

Example API calls

Read-style (read): comments.get

await corsair.instagram.api.comments.get({});

Write-style (write): carousel.post

await corsair.instagram.api.carousel.post({});

See the full list on the API page. Use pnpm corsair list --plugin=instagram and pnpm corsair schema <path> locally to inspect schemas.

Hooks

Use hooks on API calls and webhookHooks on incoming events to add logging, approvals, or side effects. See Hooks and the Webhooks page for payload types.

Reference

Topic	Link
API	API
Database	Database
Webhooks	Webhooks
Credentials	Get credentials

​Setup

​Authentication

​Webhooks

​Query synced data

​Example API calls

​Hooks

​Reference

Setup

Authentication

Webhooks

Query synced data

Example API calls

Hooks

Reference