This is reference content about building functions and workflows. Learn more if you're not yet familiar with this new Slack platform paradigm.

channel_canvas_create

Create channel canvas

Facts

Schema ID

Schema.slack.functions.ChannelCanvasCreate

Schema reference

slack#/functions/channel_canvas_create

Required scopes

canvases:readcanvases:write

Input parameters

Required parameters

channel_id

Schema.slack.types.channel_id

·Required

Select a channel

Optional parameters

canvas_create_type

Schema.types.string

·Optional

Type of creation. Options are blank or template. Default is blank. If type is blank or undefined, no canvas_template_id is needed. If type is template, provide a canvas_template_id.

canvas_template_id

Schema.slack.types.canvas_template_id

·Optional

Select a canvas template. Only needed if canvas_create_type is set to template.

content

Schema.slack.types.expanded_rich_text

·Optional

Add content. Content should only be provided if canvas_create_type is set to blank.

placeholder_values

Schema.types.object

·Optional

A dictionary of key-value pairs representing canvas variables provided only when canvas_create_type is set to template.

Output parameters

Required parameters

canvas_id

Schema.slack.types.canvas_id

·Required

Canvas link

Usage guide

This function updates creates a channel canvas. The canvas_create_type will default to blank if not provided.

The app using this function will need the following App Home features set in the app manifest file:

features: {
  appHome: {
    messagesTabEnabled: true,
    messagesTabReadOnlyEnabled: false,
  },
},

For information about the expanded_rich_text type that you can use to update your canvases, refer to expanded_rich_text.

Example workflow step:

const createChannelCanvasStep = ExampleWorkflow.addStep(
  Schema.slack.functions.ChannelCanvasCreate,
  {
    channel_id: "CHAN123456",
    canvas_create_type: "template",
    canvas_template_id: "TEM123456",
    content: { inputs.content }
  },
);