Back to Help Center

Organizing your inbox with labels

Labels turn a flat LinkedIn inbox into an organized workspace.

Use organize_conversation with action label and a label value like 'Hot Lead', 'Client', or 'Candidate' to tag a conversation. A conversation can carry multiple labels. Use action unlabel to remove one.

Once labeled, the rest of the inbox tooling understands them:

  • list_conversations with the label filter shows only threads carrying that label, a split inbox view.
  • list_labels returns every label in use with a count of conversations per label, sorted by frequency, so you can see where attention is concentrated.
  • get_inbox_status accepts the same label filter, so your morning triage can focus on 'Hot Lead' threads only.

Separately from your custom labels, Crispy classifies conversations into categories (sales, networking, recruiting, support, personal, other) and suggests them. Accept a suggestion with accept_suggested_label, or reject it with reject_suggested_label, optionally passing the correct category, which trains the classifier and sharpens future suggestions. get_inbox_status can filter by category too.

A workflow that works well:

  1. Have your agent label every promising thread the moment it appears.
  2. Each morning, run get_inbox_status filtered to your highest-value label.
  3. Weekly, run list_labels and clean up labels you stopped using.

Common mistake: creating a new label for every nuance. Ten labels you actually filter by beat forty you don't. Organizing actions share an inbox management safety limit of 200 per day, plenty for real use but not for relabeling your entire history in one sitting.

Pro tip: agree on label names with your agent up front ('Hot Lead', not sometimes 'hot-lead', sometimes 'HotLead'). Labels are plain text, consistent naming keeps your split inbox clean.

Still stuck? Email [email protected] or browse answered questions.