Workflow Troubleshooting Page

mint.json

@@ -1406,7 +1406,6 @@
             "workflow/quickstarts/hono",
             "workflow/quickstarts/express",
             "workflow/quickstarts/astro"
-
           ]
         },
         {
@@ -1451,6 +1450,12 @@
         },
         "workflow/how",
         "workflow/pricing",
+        {
+          "group": "Troubleshooting",
+          "pages": [
+            "workflow/troubleshooting/vercel"
+          ]
+        },
         "workflow/roadmap"
       ]
     }

workflow/troubleshooting/vercel.mdx

@@ -0,0 +1,38 @@
+---
+title: "Vercel"
+sidebarTitle: "Vercel"
+---
+
+# Common Issues and Solutions
+
+### Preview Deployment Protection
+
+**Problem:**
+When Deployment Protection setting is enabled on Vercel, it's not possible to trigger and complete a workflow run on a preview deployment.
+
+**Solution:**
+Vercel provides a way to bypass this protection by using a bypass secret. To create one, follow these steps:
+
+<Steps>
+	<Step title="Settings">Go to **Deployment Protection** section under your Vercel project settings.</Step>
+
+	<Step title="Find related section">
+		Click on **Add Secret** under **Protection Bypass for Automation** section.
+		<Frame>
+  			<img src="/img/workflow/troubleshooting/vercel-deployment-protection.png" />
+		</Frame>
+	</Step>
+
+	<Step title="Generate a bypass token">Don't forget to save it.</Step>
+</Steps>
+
+Now that you have a bypass token, you can add it to your workflow URL as a query parameter.
+
+Imagine that you have a Vercel Preview and there is a workflow endpoint at `https://vercel-preview.com/workflow`.
+You can call the workflow like this in preview:
+
+```bash
+curl -X POST \
+  'https://vercel-preview.com/workflow?x-vercel-protection-bypass=<PROTECTION_BYPASS_SECRET>' \
+  -d 'Hello world!'
+```