Write

Organize Conversation

Run a single organizing action on a conversation: archive, unarchive, label, unlabel, snooze, or smart_archive. Labeling needs a label value, and snooze needs a future ISO 8601 snooze_until (capped at 200 per day), with smart_archive optionally auto-returning the thread when the other person replies. The call fails if the action is unknown or the chat_id is not found.

organize_conversationPOST/api/v1/inbox/conversations/{chat_id}/organize

Get started View docs

crispy — bash

Example prompt: Label my conversation chat_9f2a as 'Hot Lead'

{
  "chat_id": "chat_9f2a",
  "action": "label",
  "label": "Hot Lead",
  "status": "ok"
}

Permission scope

core

Access

Write

Daily limit

200/day

What you can build

Tag hot leads or clients so they surface in a dedicated split-inbox view

Snooze a conversation to resurface exactly when it is time to follow up

Smart-archive a quiet thread that automatically comes back if they reply

Keep your inbox tidy by archiving or unarchiving threads on demand

Parameters

Inputs accepted by organize_conversation.

Name	Type	Required	Description
chat_id	`string`	required	ID of the conversation to organize (from list_conversations)
action	`"archive" \| "unarchive" \| "label" \| "unlabel" \| "snooze" \| "smart_archive"`	required	What to do: archive \| unarchive \| label \| unlabel \| snooze \| smart_archive
label	`string`	optional	Label text for label/unlabel actions (e.g. 'Hot Lead', 'Client'). Required for label and unlabel actions.
snooze_until	`string`	optional	ISO 8601 datetime when to resurface (e.g. '2026-04-16T09:00:00Z'). Required for snooze action. Must be in the future.
note	`string`	optional	Optional note for snooze action (e.g. 'Follow up on proposal'). Not sent, just for your reference.
return_on_reply	`boolean`	optional	For smart_archive: if true (default), conversation auto-returns when other person replies.

Related tools

List Conversation Labels

List all labels in use across your LinkedIn conversations with usage counts, sorted by frequency, to power a clean, split-inbox workflow.

List LinkedIn Conversations

List LinkedIn conversations with last message previews, label filters, and whose-turn flags so your AI agent can prioritize replies fast.

Bulk Archive Stale Conversations

Archive stale LinkedIn conversations older than N days where you sent last, with a dry-run preview. Threads auto-return the moment the other person replies.

Explore all Outreach tools

The complete LinkedIn API. Ready when you are.

Connect your first LinkedIn profile in under 5 minutes. Every tool, every seat, no feature gates. Safe limits, warm-up, and full permission control built in.

Start now Read the docs