Create Channel
twake.create_channel
ActionChat & messagingconnection required
Calls the Twake API with the connection's credentials.
Create a channel in a workspace.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Twake
- Secret shape
- {"app_id": "…", "app_secret": "…"} — the application's API settings
- Config it needs
- base_url, company_id, workspace_id
- Resolved by
- config.connection_id, else node.connection_id
Configuration
7 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
name The channel's display name. | string | Yes | — | — | release-announcements |
visibility Whether anyone in the workspace can find and join the channel. | string | No | public | one of "public", "private" | — |
description What the channel is for; shown under its name in Twake. | string | No | — | — | — |
icon An emoji shown next to the channel name. | string | No | — | — | 🚀 |
channel_group Name of the group the channel is filed under in the sidebar. | string | No | — | — | — |
company_id Twake company to act in; overrides the company set on the connection. | string | No | — | — | a1b2c3d4-1111-2222-3333-444455556666 |
workspace_id Twake workspace to act in; overrides the workspace set on the connection. | string | No | — | — | 99887766-aaaa-bbbb-cccc-ddddeeeeffff |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"company_id": "a1b2c3d4-1111-2222-3333-444455556666",
"icon": "🚀",
"name": "release-announcements",
"visibility": "public",
"workspace_id": "99887766-aaaa-bbbb-cccc-ddddeeeeffff"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
id The channel id. | string | — |
name The channel's display name. | string | — |
description The channel's description, empty when none was set. | string | — |
visibility One of 'public', 'private' or 'direct'. | string | — |
company_id The company the channel belongs to. | string | — |
workspace_id The workspace the channel belongs to. | string | — |
owner Id of the channel's owner. | string | — |
archived True when the channel has been archived. | boolean | — |
icon The channel's icon, empty when none was set. | string | — |
last_activity Time of the last message, as a millisecond epoch. | number | — |
{
"archived": false,
"company_id": "",
"description": "",
"icon": "",
"id": "",
"last_activity": 0,
"name": "",
"owner": "",
"visibility": "",
"workspace_id": ""
}See Create Channel run in a workflow.
In a technical demo we add the Twake connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.