How To Use It

See how, below. Install to get your real webhook URL.

Your Webhook URL

https://immabark.com/api/webhook/YOUR_API_KEY

First: Invite immabark to any channel you want to post to by typing /invite @immabark in that channel. You can invite it to as many channels as you want.

Simple Alerts

Use for status changes where the fact that something happened matters more details about what happened. Repeated alerts update the same message with a timestamp and count.

Examples: API outages, deployment failures, service restarts

curl -X POST https://immabark.com/api/webhook/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
  "channel": "#ops-alerts",
  "text": ":warning: Payment API unavailable",
  "blocks": "Connection timeout after 30s"
}'

Threaded Alerts

Use when each occurrence has unique details you need to review. Set threadReplies: true to post each alert as a thread reply.

Examples: validation errors, failed transactions, malformed records

curl -X POST https://immabark.com/api/webhook/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
  "channel": "#data-errors",
  "text": ":x: Invalid record in import batch",
  "blocks": "Row 847: Missing required field \"email\"",
  "options": {
    "threadReplies": true
  }
}'

Rate Limiting

Add a threshold to suppress noise. Alerts are only sent when the rate exceeds the threshold.

Format: 5/hr, 10/min, or 1/day

Example: "threshold": "3/hr"

1st–3rd call within an hour: suppressed (counted but not sent)
4th call: alert is sent
Window resets after the hour expires

Payload Reference

Field	Type	Description
`channel`	string	Channel name or ID (required)
`text`	string	Alert message with Slack markdown (required)
`blocks`	string \| array	Additional context (string) or Block Kit JSON (array)
`options.threadReplies`	boolean	Post repeats as thread replies instead of updating
`options.threshold`	string	Rate threshold like `5/hr`, `10/min`, or `1/day`

Slash Commands

Use /imma in Slack to manage your account.

/imma status Show alert stats and credits

/imma reup View account, docs, and refresh credits

/imma clear Clear alert history for this channel

/imma clearall Clear all alert history for workspace

1 credit = 1 alert sent to Slack

Part of StripMall Software