diff --git a/docs/management/connectors/action-types/slack.asciidoc b/docs/management/connectors/action-types/slack.asciidoc
index 14e08d3cc6f25..60c33a0368aba 100644
--- a/docs/management/connectors/action-types/slack.asciidoc
+++ b/docs/management/connectors/action-types/slack.asciidoc
@@ -38,14 +38,19 @@ For Slack setup details, go to <<configuring-slack>>.
 === Test connectors
 
 You can test connectors as you're creating or editing the connector in {kib}.
-For example: 
+For the webhook type of connector, its message text cannot contain Markdown, images, or other advanced formatting:
 
 [role="screenshot"]
 image::management/connectors/images/slack-webhook-params.png[Slack webhook connector test]
 // NOTE: This is an autogenerated screenshot. Do not edit it directly.
 
-Slack connector actions have message text, which cannot contain Markdown, images, or other advanced formatting.
-For the web API type of connector, you must also choose one of the channel IDs.
+For the web API type of connector, you must choose one of the channel IDs.
+You can then test either plain text or block kit messages:
+
+[role="screenshot"]
+image::management/connectors/images/slack-api-connector-test.png[Slack web API connector test]
+
+After you add block kit messages you can click a link to preview them in the Slack block kit builder.
 
 [float]
 [[slack-connector-networking-configuration]]
diff --git a/docs/management/connectors/images/slack-api-connector-test.png b/docs/management/connectors/images/slack-api-connector-test.png
new file mode 100644
index 0000000000000..fd0cfb7631e71
Binary files /dev/null and b/docs/management/connectors/images/slack-api-connector-test.png differ
diff --git a/docs/management/connectors/images/slack-webhook-params.png b/docs/management/connectors/images/slack-webhook-params.png
index 7ec14a906c409..aca65db50cbe3 100644
Binary files a/docs/management/connectors/images/slack-webhook-params.png and b/docs/management/connectors/images/slack-webhook-params.png differ
diff --git a/x-pack/plugins/actions/docs/openapi/bundled.json b/x-pack/plugins/actions/docs/openapi/bundled.json
index 11b49c59076d5..b0725ee457385 100644
--- a/x-pack/plugins/actions/docs/openapi/bundled.json
+++ b/x-pack/plugins/actions/docs/openapi/bundled.json
@@ -6102,7 +6102,7 @@
               },
               "text": {
                 "type": "string",
-                "description": "The Slack message text, which cannot contain Markdown, images, or other advanced formatting.",
+                "description": "The Slack message text. If it is a Slack webhook connector, the text cannot contain Markdown, images, or other advanced formatting. If it is a Slack web API connector, it can contain either plain text or block kit messages.\n",
                 "minLength": 1
               }
             }
@@ -7063,4 +7063,4 @@
       }
     }
   }
-}
+}
\ No newline at end of file
diff --git a/x-pack/plugins/actions/docs/openapi/bundled.yaml b/x-pack/plugins/actions/docs/openapi/bundled.yaml
index 5d73ef1896e67..16d3630c30223 100644
--- a/x-pack/plugins/actions/docs/openapi/bundled.yaml
+++ b/x-pack/plugins/actions/docs/openapi/bundled.yaml
@@ -4278,7 +4278,8 @@ components:
                 type: string
             text:
               type: string
-              description: The Slack message text, which cannot contain Markdown, images, or other advanced formatting.
+              description: |
+                The Slack message text. If it is a Slack webhook connector, the text cannot contain Markdown, images, or other advanced formatting. If it is a Slack web API connector, it can contain either plain text or block kit messages.
               minLength: 1
     run_connector_subaction_validchannelid:
       title: The validChannelId subaction
diff --git a/x-pack/plugins/actions/docs/openapi/bundled_serverless.json b/x-pack/plugins/actions/docs/openapi/bundled_serverless.json
index 273b26c19eb88..79ed191158db1 100644
--- a/x-pack/plugins/actions/docs/openapi/bundled_serverless.json
+++ b/x-pack/plugins/actions/docs/openapi/bundled_serverless.json
@@ -4418,4 +4418,4 @@
       }
     }
   }
-}
+}
\ No newline at end of file
diff --git a/x-pack/plugins/actions/docs/openapi/components/schemas/run_connector_subaction_postmessage.yaml b/x-pack/plugins/actions/docs/openapi/components/schemas/run_connector_subaction_postmessage.yaml
index ef2730169f416..4625c4c5d2ef2 100644
--- a/x-pack/plugins/actions/docs/openapi/components/schemas/run_connector_subaction_postmessage.yaml
+++ b/x-pack/plugins/actions/docs/openapi/components/schemas/run_connector_subaction_postmessage.yaml
@@ -33,6 +33,9 @@ properties:
           type: string
       text:
         type: string
-        description: The Slack message text, which cannot contain Markdown, images, or other advanced formatting.
+        description: >
+          The Slack message text.
+          If it is a Slack webhook connector, the text cannot contain Markdown, images, or other advanced formatting.
+          If it is a Slack web API connector, it can contain either plain text or block kit messages.
         minLength: 1
        
\ No newline at end of file