---
title: "Enqueue a conversation session"
method: POST
path: "/conversation-sessions/enqueue"
tags: ["Conversation sessions"]
---

# Enqueue a conversation session

`POST /conversation-sessions/enqueue`

Enqueues the open conversation session for a contact into a queue and persists the observation as transfer_observation.

## Request body

- object
  - `waId` string, required — Contact WhatsApp ID
  - `phoneNumberWaId` string, required — Business phone WhatsApp ID
  - `queueId` string, uuid, required — Queue id
  - `observation` string, required — Observation persisted on the session as transfer_observation

## Response `200`

Session enqueued successfully

- object
  - `id` string, uuid, required
  - `conversationId` string, uuid, required
  - `status` string, required
  - `currentQueueId` string, uuid, nullable, required
  - `enqueueDate` string, date-time, nullable, required
  - `ticketId` integer, nullable, required
  - `transferObservation` string, nullable, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Queue, conversation, or open session not found
- `500` — Internal server error

## Changes

- **2026-07-28** `8ccfb9a461e2` — 8 breaking, 9 info
  - the `observation` request property's minLength was increased from `0` to `1`
  - the `phoneNumberWaId` request property's minLength was increased from `0` to `1`
  - the `waId` request property's minLength was increased from `0` to `1`
  - added the pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$` to the request property `queueId`
  - …13 more
- **2026-07-23** `373ee68a440c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/indigohive/apis/cogfy-messenger-public-api/changes/conversation-sessions/enqueue/post.md)

---

[API](https://skmtc.dev/indigohive/apis/cogfy-messenger-public-api.md) · [All operations](https://skmtc.dev/indigohive/apis/cogfy-messenger-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/indigohive/cogfy-messenger-public-api/revisions/30bd33ee45c9/schema)