Instagram Messaging

Ice Breakers

Updated: Jul 2, 2026
Ice Breakers provide a way for users to start a conversation with a business with a list of frequently asked questions. Use the Ice Breaker API to set a maximum of 4 questions.
Instagram chat with the Coast Clothing business showing four Ice Breakers questions above the message box

Limitations

Ice Breakers are currently not available on desktop.

Setting ice breakers

    curl -X POST -H "Content-Type: application/json" -d '{
     "platform": "instagram",
     "ice_breakers":[
       {
          "call_to_actions":[
             {
                "question":"<QUESTION>",
                "payload":"<PAYLOAD>"
             },
             {
                "question":"<QUESTION>",
                "payload":"<PAYLOAD>"
             }
          ],
          "locale":"default" // default locale is REQUIRED
       },
       {
          "call_to_actions":[
             {
                "question":"<QUESTION>",
                "payload":"<PAYLOAD>"
             },
             {
                "question":"<QUESTION>",
                "payload":"<PAYLOAD>"
             }
          ],
          "locale":"en_GB"
       }
    ]
}' "https://graph.facebook.com/v11.0/me/messenger_profile?platform=instagram&access_token=<PAGE_ACCESS_TOKEN>"

Getting ice breakers

curl -X GET "https://graph.facebook.com/v11.0/me/messenger_profile?fields=ice_breakers&platform=instagram&access_token=<PAGE_ACCESS_TOKEN>"
{
   "data": [
        {
          "call_to_actions" : [
               {
                "question": "<QUESTION>",
                "payload": "<PAYLOAD>",

               },
               {
                "question": "<QUESTION>",
                "payload": "<PAYLOAD>",

               },
          ],
          "locale": "<LOCALE>",
      },
      {
          "call_to_actions" : [
               {
                "question": "<QUESTION>",
                "payload": "<PAYLOAD>",

               },
               {
                "question": "<QUESTION>",
                "payload": "<PAYLOAD>",

               },
          ],
          "locale": "<LOCALE>",
      }
   ]
}

Deleting ice breakers

curl -X DELETE -H "Content-Type: application/json" -d '{
  "fields": [
    "ice_breakers",
  ]
}' "https://graph.facebook.com/v11.0/me/messenger_profile?platform=instagram&access_token=%lt;PAGE_ACCESS_TOKEN>"

Webhook event

To receive postback webhooks from Ice Breakers, subscribe your app to the messaging_postbacks webhook under the Instagram topic in your app settings.
Your app receives a JSON payload similar to the following example.
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IGID>",
      "time": 1502905976963,
      "messaging": [
        {
          "sender": {
            "id": "<IGSID>"
          },
          "recipient": {
            "id": "<IGID>"
          },
          "timestamp": 1502905976377,
          "postback": {
            "title": "<SELECTED_ICEBREAKER_QUESTION>",
            "payload": "<USER_DEFINED_PAYLOAD>",
          }
        }
      ]
    }
  ]
}

Developer Support