ClickUp Troubleshooting
Common issues and how to resolve them.
Tasks Not Being Detected
If Jasper isn't detecting task IDs from your PRs:
- Verify the task ID pattern - Check that your pattern matches your ClickUp task IDs in Settings → ClickUp
- Ensure the task exists - The task must exist in a mapped ClickUp space
- Check detection sources - Verify that detection sources (branch, title, etc.) are enabled
- Test the pattern - Use the "Test Detection" feature in repository mapping settings
Common Pattern Issues
| Issue | Solution |
|---|---|
| Pattern too strict | Use CU-[a-zA-Z0-9]+ instead of CU-[0-9]+ |
| Missing prefix | Ensure your branch/title includes CU- prefix |
| Wrong case | Task IDs are case-sensitive - use exact match |
Status Not Syncing
If task status isn't updating when PRs are merged:
- Confirm status mapping - Check that status mapping is configured in Settings → ClickUp
- Verify target status exists - The status name must exist in your ClickUp space
- Check webhook logs - Look for errors in Settings → Webhook Logs
- Enable status sync - Ensure "Sync PR status to ClickUp" is toggled on
OAuth Connection Issues
If you're having trouble connecting to ClickUp:
- Try reconnecting - Disconnect and reconnect the integration
- Check permissions - Ensure you have admin access to the ClickUp workspace
- Verify app access - Third-party app access must be enabled in ClickUp settings
- Clear browser cache - Clear cookies and try again in an incognito window
Webhooks Not Appearing in Logs
If webhooks aren't showing up in Webhook Logs:
- Verify endpoint URL - Must be exactly
https://heyjasper.ai/webhooks/clickup - Check webhook status - Ensure the webhook is active in ClickUp (not paused or errored)
- Confirm workspace connection - Your ClickUp workspace must be connected to Jasper via OAuth
- Test with an action - Update a task in ClickUp and check logs within a few seconds
Webhook Signature Verification Failures
If you see 401 errors or signature verification failures:
- Check your secret - Go to Settings → ClickUp → Webhook Settings and verify your secret is configured
- Match secrets exactly - The secret in Jasper must match the secret used when creating the webhook in ClickUp
- No extra characters - Check for trailing whitespace or extra characters
- Regenerate if needed - Click "Regenerate Secret" in Jasper and update the webhook in ClickUp
Tip: If you don't need signature verification, you can click "Remove secret" in the Webhook Settings section. This will accept all webhooks without verification (not recommended for production).
Auto Comments Not Posting
If review comments aren't appearing on ClickUp tasks:
- Check the toggle - Ensure "Auto-post review comments to tasks" is enabled
- Verify task detection - The PR must have detected and linked task IDs
- Check ClickUp permissions - The connected account needs permission to post comments
- Review wasn't completed - Comments only post when reviews complete successfully
Quick Links
- ClickUp Settings - Main configuration page
- Webhook Logs - View incoming webhook activity
- PR Naming Settings - Configure naming enforcement
- Ticket Templates - Configure description templates
Still Need Help?
If you're still experiencing issues:
- Check our General Troubleshooting Guide
- Visit our FAQ
- Contact support at [email protected]