POST /chat.unfurl

Provide custom unfurl behavior for user-posted URLs

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/x-www-form-urlencoded"

token String Yes

Authentication token. Requires scope: links:write

Request body fields

Name Type Required Description
channel String Yes

Channel ID of the message

ts String Yes

Timestamp of the message to add unfurl behavior to.

unfurls String No

URL-encoded JSON map with keys set to URLs featured in the the message, pointing to their unfurl blocks or message attachments.

user_auth_url String No

Send users to this custom URL where they will complete authentication in your app to fully trigger unfurling. Value should be properly URL-encoded.

user_auth_message String No

Provide a simply-formatted string to send as an ephemeral message to the user as invitation to authenticate further and enable full unfurling behavior

user_auth_required Boolean No

Set to true or 1 to indicate the user must install your Slack app to trigger unfurls for this domain

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.