Skip to content
Proud to collaborate with Microsoft for Startups

slack.workspace.sync ​

Sync a Slack workspace (channels + users + user groups) into the platform DB.

Sync a Slack workspace's channels, users, and user groups into the DB.

Overview ​

PropertyValue
Workflow typeDag
LibraryApp-slack
Version1.0

Input Schema ​

FieldTypeRequiredDefaultDescription
workflow_run_idstringNo—DAG-stamped parent run id (auto-injected by the engine)
organization_uuiduuidYes—Organization that owns the Slack connection
connection_uuiduuidYes—Slack CloudConnection UUID
include_privatebooleanNo—Include private channels (default true)
include_imbooleanNo—Include im/mpim conversations (default false)

Output Schema ​

FieldTypeRequiredDefaultDescription
workflow_run_uuiduuidNo——
organization_uuidjsonNo——
connection_uuidjsonNo——
include_privatejsonNo——
include_imjsonNo——
channelsjsonNo——
usersjsonNo——
usergroupsjsonNo——
errorstringNo——
error_typestringNo——
failed_atstringNo——
failed_at_statestringNo——
failed_layerjsonNo——
failed_stepstringNo——
failure_reasonstringNo——
compensation_triggerjsonNo——
comp_queuejsonNo——
comp_current_layerjsonNo——
comp_retry_countjsonNo——

DAG Layers ​

#LayerStepsCompensation
1syncslack.channels.sync, slack.users.sync, slack.usergroups.sync—

Execution Flow ​

Sub-workflows ​

Sub-workflowStep name
slack.channels.syncchannels
slack.users.syncusers
slack.usergroups.syncusergroups

API Usage ​

bash
POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "slack.workspace.sync",
  "initial_data": {
    "organization_uuid": "value",
    "connection_uuid": "value"
  }
}