Snooze conversation

Snooze a conversation until a time or until the customer replies.

POST https://cotlet.dev/api/v1/kustomer/conversations/{conversation_id}/snooze

write

Sets the status to Snoozed. Choose a date and time to return to Open, or snooze until the customer replies. When the snooze ends, the assigned user gets an email and a notification. Snoozing reaches no customer and one more call removes it, so this call does not ask for confirmation. Your workflows run as usual after the status change.

Parameters

Parameters: snooze_conversation
NameTypeDescription
conversation_id string required string Conversation ID from search_conversations.
until string string ISO date and time when it returns to Open. Leave out to snooze until the customer replies.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/kustomer/conversations/conversation_8c41d2/snooze \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("kustomer", "snooze_conversation", {"conversation_id":"conversation_8c41d2"})
Node.js
const result = await cotlet.call('kustomer', 'snooze_conversation', {"conversation_id":"conversation_8c41d2"});
CLI
cotlet call kustomer snooze_conversation --data '{"conversation_id":"conversation_8c41d2"}'

Example response

JSON

{
  "conversation_id": "6718d2e4a1b2c3d4e5f60733",
  "status": "snoozed",
  "snooze_until": "2026-10-20T09:00:00Z",
  "updated_at": "2026-10-17T09:03:00Z"
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.