Messaging - PlugKit

PlugKit exposes a connected account’s inbox as conversations and messages, the same shape across Instagram, WhatsApp and Telegram.

Sync from the platform

Inbound messages arrive via webhooks, but you can also pull the current state from the platform’s live API — handy on first connection or if you don’t run webhooks:

curl -X POST "https://api.plugkit.co/v1/conversations/sync?accountId=ACCOUNT_ID" \
  -H "Authorization: Bearer sk_your_key"

Returns how many conversations and messages were synced.

List conversations

curl "https://api.plugkit.co/v1/conversations?accountId=ACCOUNT_ID" \
  -H "Authorization: Bearer sk_your_key"

Read a conversation

curl https://api.plugkit.co/v1/conversations/CONVERSATION_ID/messages \
  -H "Authorization: Bearer sk_your_key"

Send a reply

curl -X POST https://api.plugkit.co/v1/conversations/CONVERSATION_ID/messages \
  -H "Authorization: Bearer sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "text": "Thanks for reaching out! 👋" }'

Send a direct DM (Instagram, no existing conversation)

Message an Instagram user by their IGSID without an existing thread:

curl -X POST https://api.plugkit.co/v1/accounts/ACCOUNT_ID/messages/send \
  -H "Authorization: Bearer sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "recipientId": "178414...", "text": "Hi there!" }'

New inbound messages are delivered in real time via webhooks — see Webhooks. Instagram messaging requires the instagram_business_manage_messages permission, and (per Meta’s rule) the user must have messaged you within the last 24h unless you use an approved template.