API overview

What you can do

send Instagram DMs through your connected account
receive incoming DMs, reactions, reads, and message events in your webhook
list connected channels and fetch channel tokens
set or clear the webhook destination for a channel
rotate a channel token if it leaks
publish images, reels, stories, and carousels
read account and media insights
list, reply to, hide, and delete comments

Authentication

Use two tokens:

Token	Use it for	Base URL
`hmok_` API key	Manage orgs, workspaces, channels, webhooks, and channel tokens	`https://api.hookmyapp.com`
`hmat_` channel token	Call Meta’s Instagram API (DMs, publishing, insights, comments) through one connected channel	`https://gateway.hookmyapp.com/meta/v25.0`

Fetch the channel token with an hmok_ API key:

curl https://api.hookmyapp.com/meta/channels/{channelId}/token \
  -H "Authorization: Bearer hmok_..." \
  -H "X-Workspace-Id: ws_..."

Use the returned hmat_ token to send:

curl -X POST https://gateway.hookmyapp.com/meta/v25.0/{INSTAGRAM_ACCOUNT_ID}/messages \
  -H "Authorization: Bearer hmat_..." \
  -H "Content-Type: application/json" \
  -d '{"recipient":{"id":"17841400000000000"},"message":{"text":"Hello"}}'

You can also get the same channel token with hookmyapp channels env <channel>.

The version-pinned base URL (.../meta/v25.0) is the exact value HookMyApp emits as META_GRAPH_API_URL from hookmyapp channels env <channel>. Read the base URL from that variable instead of hardcoding the version, so a Meta Graph API version bump doesn’t leave your requests pinned to an old version.

Next steps

Send a message: Send Instagram DMs.
Send text guide: Send an Instagram text DM.
Receive webhooks: Handle inbound DMs and read the IGSID.

Getting started

Sending & receiving

Publish & engage

Tools

API Reference

What you can do

Authentication

Next steps

​What you can do

​Authentication

​Next steps

What you can do

Authentication

Next steps