Developer API

Find the conversation, group, and newsletter IDs used by the messaging API.

Message Destinations

Find Message Destinations

Use these lookup endpoints to find the IDs accepted by to in the send-message endpoint.

Direct messages and conversations

Complete list-conversations request
curl -X GET "https://app.querygen.ai/api/v1/conversations?type=dm" \
  -H "Authorization: Bearer qg_xxxxxxxxxxxxx" \
  -H "X-Organization-Id: <organization-id>"
Conversations response
{
  "success": true,
  "data": [
    {
      "conversation_id": "919876543210@s.whatsapp.net:whatsapp",
      "chat_id": "919876543210@s.whatsapp.net",
      "chat_name": "Customer One",
      "chat_type": "dm",
      "platform": "whatsapp",
      "user_phone": "919820160046",
      "send_to": "919876543210"
    }
  ],
  "total": 1,
  "source": "sidecar"
}

Groups

Complete list-groups request
curl -X GET "https://app.querygen.ai/api/v1/groups" \
  -H "Authorization: Bearer qg_xxxxxxxxxxxxx" \
  -H "X-Organization-Id: <organization-id>"
Groups response
{
  "success": true,
  "data": [
    {
      "group_id": "120363019820160046@g.us",
      "group_name": "Project Team",
      "platform": "whatsapp"
    }
  ],
  "total": 1,
  "source": "sidecar"
}

Newsletters

Complete list-newsletters request
curl -X GET "https://app.querygen.ai/api/v1/channels" \
  -H "Authorization: Bearer qg_xxxxxxxxxxxxx" \
  -H "X-Organization-Id: <organization-id>"
Newsletters response
{
  "success": true,
  "data": [
    {
      "channel_id": "120363999999999999@newsletter",
      "channel_name": "Happy Eaters Announcements",
      "platform": "whatsapp"
    }
  ],
  "total": 1
      }