Instagram

Instagram is fully supported in V1 — OAuth connect, publishing, inbox, analytics, and comment-to-DM automations.

Connect an account

Create a Meta app with Instagram API product in the Meta Developer Portal
Set INSTAGRAM_APP_ID and INSTAGRAM_APP_SECRET on your Aether deployment
Generate a Connect Link with "platform": "instagram"

Local development

Meta rejects http://localhost redirect URIs. You need a public HTTPS URL — use any tunnel tool (ngrok, frp, etc.) and register the HTTPS callback in the Meta portal.

Content types

Use overrides.instagram.contentType:

Value	Description
`feed`	Standard feed post (default)
`story`	Instagram Story
`reel`	Instagram Reel

{
  "text": "Behind the scenes",
  "profileIds": ["prof_ig123"],
  "overrides": {
    "instagram": {
      "contentType": "reel",
      "mediaUrls": ["https://cdn.example.com/reel.mp4"]
    }
  }
}

Instagram-specific overrides

Field	Description
`userTags`	Tag users with x/y coordinates on images
`collaborators`	Up to 3 collaborator usernames
`shareToFeed`	Share Reel to main feed
`firstComment`	Auto-post first comment after publish

Media requirements

Images: JPEG, PNG — max dimensions per Meta guidelines
Video/Reels: MP4, recommended H.264
Upload via presigned URLs before attaching mediaUrls

Inbox and DMs

Instagram DMs and comments appear in the unified inbox. Reply via POST /inbox/:id/reply or send private replies with automations.

Webhooks (incoming)

Live Meta webhook ingestion for comments is planned for Phase 3b. Until then, use automation test triggers and the private-reply API.