Slack Notifications

ApiMeld sends Slack notifications via Slack's Incoming Webhooks feature. Each webhook posts to a specific channel in your workspace.

1. Create a Slack Incoming Webhook

1. Go to api.slack.com/apps and click Create New App
2. Choose From scratch, give it a name (e.g. "ApiMeld"), and select your workspace
3. In the left sidebar, click Incoming Webhooks
4. Toggle Activate Incoming Webhooks to On
5. Click Add New Webhook to Workspace
6. Select the channel you want ApiMeld to post to
7. Copy the webhook URL — it looks like:

   https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Channel per environment

Consider creating separate webhooks for different channels — e.g. #apimeld-prod for production failures and #apimeld-dev for development runs. Each gets its own named webhook in ApiMeld.

2. Add the webhook to ApiMeld

1. Go to Admin → Settings → Notifications
2. Under Slack Webhooks, click Add
3. Enter a name (e.g. "Ops Channel", "Dev Alerts") and paste the webhook URL
4. Click Save

3. Enable on a task

1. Open a task and go to the Notifications tab
2. Select the Slack webhook(s) to notify
3. Choose the trigger events: On Success, On Failure, On Timeout
4. Save the task

Message format

ApiMeld posts a structured message to Slack containing:

• Task name and run status (✅ Success / ❌ Failed / ⏱ Timed Out)
• Start time and duration
• Last few lines of output (truncated for long output)
• A link to the full run log

Example notification

✅ ApiMeld — Task Succeeded
Task:     Nightly Order Sync
Status:   Success
Duration: 12.4s
Output:   Synced 1,247 orders. 3 skipped (already up to date).
[View full log →]

Testing the webhook

After saving, click Test next to the webhook in Admin → Settings → Notifications to send a test message to the channel and confirm it's working.