API overview

What you can do

send Messenger messages from your connected Page
receive incoming messages, reactions, reads, deliveries, postbacks, comments and post 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 text, links, photos, videos and reels, and delete posts
read Page and post insights
list, reply to, hide and delete comments, and answer commenters in private

Authentication

Use two tokens:

Token	Use it for	Base URL
`hmok_` API key	Manage orgs, workspaces, channels, webhooks, channel tokens, and publish reels	`https://api.hookmyapp.com`
`hmat_` channel token	Call Meta’s Page API (Messenger, posts, comments, insights) 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/{PAGE_ID}/messages \
  -H "Authorization: Bearer hmat_..." \
  -H "Content-Type: application/json" \
  -d '{"recipient":{"id":"200000000000001"},"message":{"text":"Hello"}}'

You can also get the same channel token with hookmyapp channels token <channel>. The Page id is on GET /meta/channels/{id} as metaResourceId. The channel token only reaches the Page it was minted for, and the Instagram account linked to that Page. Any other Page, post, comment or thread is refused with FACEBOOK_SCOPE_DENIED.

Next steps

Send a message: Send Messenger messages.
Receive webhooks: Handle inbound events and read the PSID.

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