Developer docs

IotaBot Instagram API

Every DM and comment on your webhook. Reply from your code.

Get an API key

Test the Instagram API without sending messages

Test keys run every check and never send.

POST/v1/test/inboundSign in to try

Simulate a DM

Request
curl -X POST "https://api.iotabot.com/v1/test/inbound" \
  -H "Authorization: Bearer $IOTABOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "channel": "instagram",
  "from": "sandbox-ig-user-1",
  "name": "Priya",
  "text": "Is this available in blue?"
}'
Response · 201
{
  "data": {
    "livemode": false,
    "conversation": {
      "id": "6a4bc1…",
      "object": "conversation",
      "channel": "instagram",
      "status": "open",
      "mode": "ai"
    },
    "message": {
      "id": "6a4bc2…",
      "object": "message",
      "direction": "inbound",
      "text": "Hi, where is my order #1042?",
      "status": "received"
    }
  }
}
Errors
test_key_requiredchannel_not_allowedwebsite_not_allowed
POST/v1/test/inboundSign in to try

Simulate a comment

comment: true starts a comment thread instead of a DM.

Request
curl -X POST "https://api.iotabot.com/v1/test/inbound" \
  -H "Authorization: Bearer $IOTABOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "channel": "instagram",
  "from": "sandbox-ig-user-1",
  "name": "Priya",
  "text": "Price?",
  "comment": true
}'
Response · 201
{
  "data": {
    "livemode": false,
    "conversation": {
      "id": "6a4bc1…",
      "object": "conversation",
      "channel": "instagram",
      "status": "open",
      "mode": "ai"
    },
    "message": {
      "id": "6a4bc2…",
      "object": "message",
      "direction": "inbound",
      "text": "Hi, where is my order #1042?",
      "status": "received"
    }
  }
}
Errors
test_key_requiredchannel_not_allowedwebsite_not_allowed