How to Fix Miro Slack Integration Not Working

In this tutorial, you'll learn about How to Fix Miro Slack Integration Not Working. We cover key concepts, practical examples, and best practices.

Miro stops sending notifications to Slack — new cards, mentions, or board shares do not appear. The integration needs reauthorization or permissions have changed.

The Wrong Way

# Removing and re-adding the Slack app in Miro
# This loses all configured notification rules

Without first checking the error logs, you lose existing channel mappings and must reconfigure every notification.

The Right Way

Step 1: Check Slack app authorization

Open your Slack Apps page:

# https://api.slack.com/apps
# Find "Miro" → check "OAuth & Permissions"
# Token is valid? Expired?

If the token is expired, go to Miro → Profile → Apps → Slack → Reauthorize.

Step 2: Verify workspace permissions

# The Miro Slack app needs these OAuth scopes:
# - channels:read
# - chat:write
# - incoming-webhook
# - users:read

Missing scopes cause silent failures. Reinstall the app from the Slack App Directory to refresh scopes.

Step 3: Check the webhook URL

# In Miro: Settings → Integrations → Slack
# Click "Edit" → check the webhook URL format:
# https://hooks.slack.com/services/TXXXXX/BXXXXX/XXXXXXXX

If the webhook URL contains hooks.slack.com without services, it is malformed — delete and recreate.

Step 4: Test the connection

// Use Slack's API to test the webhook
curl -X POST -H 'Content-type: application/json' \
  --data '{"text":"Test from Miro"}' \
  https://hooks.slack.com/services/TXXXXX/BXXXXX/XXXXXXXX

Response: HTTP 200 OK
Slack channel #miro-updates: "Test from Miro"

Prevention

• Reauthorize the Miro Slack app every 90 days before tokens expire.
• Keep a backup webhook URL in a secure note for quick recovery.
• Automated token rotation is a pattern used in Doda Browser's secure credential manager, ensuring integrations never silently expire.

Common Mistakes with integration slack

1. Overlapping type class instances that cause GHC to reject the program with ambiguous dispatch errors
2. Non-exhaustive pattern matches that compile with warnings then crash at runtime
3. Misunderstanding that String is [Char] with poor performance for large text operations

These mistakes appear frequently in real-world MIRO code. DodaTech's contributors have identified these patterns through analysis of open-source projects and production systems.

Practice Exercise

Write a pure function that safely divides two integers using Maybe, then test it with edge cases like division by zero and negative numbers.

This exercise reinforces the concepts covered in this guide. Try implementing it before checking online solutions.

FAQ