Skip to main content

​
What It Does

  • Automate setting or updating a channel’s purpose to reflect project goals or status.
  • Keep teams aligned by ensuring channel descriptions are always current.
  • Standardize communication across channels for faster onboarding and governance.
  • Eliminate manual updates and reduce confusion in busy Slack workspaces.
  • Feed updated channel info into reporting or notification workflows.

​
🏁 Getting Started

Slack Node config screenshot
1

Connect Slack Workspace

Choose the connected Slack account where the channel lives.
2

Configure Channel & Purpose

Select which channel to update and define the new description text.

​
Inputs

​
🛠️ Required Fields

  • Slack Workspace (✅)
    Select your connected Slack app instance.
    Why it matters: Ensures you’re updating the right workspace so channel updates don’t end up in the wrong place.
  • Channel (✅)
    Pick a public or private channel, or a user/group DM.
    Why it matters: Targets the exact discussion space—no more setting descriptions for the wrong channel.
  • Purpose (✅)
    Text of the new channel purpose.
    Why it matters: Clearly communicates the channel’s objective to everyone, reducing onboarding friction and confusion.

​
🎯 Optional Fields

None

​
Output

This action returns the updated channel object, including the new purpose field. You can route this output into downstream nodes for logging, notifications, or dashboard updates.
Slack Node output screenshot

​
How It Works

  1. Authenticates with your Slack workspace using the connected app.
  2. Locates the specified channel by its ID.
  3. Calls conversations.setPurpose to update the channel description.
  4. Emits the updated channel object for downstream processing.

​
🚀 Example Use Cases & Prompts

Use CaseSetup or Prompt Example
Align Campaign Channels”When launching a new campaign, set channel purpose to ‘Monthly Marketing Campaign Updates’.”
Onboard New Teams”Automatically update channel purpose to include onboarding docs link.”
Pipeline Stage Updates”Set channel purpose to ‘Current Pipeline Stage: Qualification’ when stage changes.”

​
✨ Pro Tips

  • Use the Insert Input button to dynamically set purpose based on workflow variables (e.g., @PipelineStage).
  • Keep your descriptions concise—Slack limits purpose to 250 characters for clarity.

​
⚠️ Important Considerations

  • Ensure your Slack app has the conversations:write scope and appropriate channel permissions.
  • Attempting to update a non-existent or archived channel will cause the node to error.

​
🛠 Troubleshooting & Gotchas

SymptomLikely CauseQuick Fix
Purpose not updatingMissing write permissionsGrant conversations:write scope or reconnect the app.
Error: channel_not_foundWrong channel ID or restricted channelVerify channel ID and that the bot is a member.

​
📝 FAQ

✅ Yes — as long as the Slack app is invited to the private channel, you can update its purpose.
The node will clear the existing description. Use this to reset channel purposes when needed.
Yes — action nodes like Set Channel Description are free.

​
💰 Pricing

ActionCredit Cost
Set Channel Description RunFree
Action nodes like Set Channel Description are free to run and won’t consume credits.

Use the Set Channel Description node to keep your Slack channels purposeful and aligned — effortlessly. 🚀