# Minipostiz Discord Setup

> Discord webhook setup for minipostiz-cli — create webhook in a channel, store URL

- Skill: `javimosch/minipostiz-discord-setup` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/minipostiz-discord-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/minipostiz-discord-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/minipostiz-discord-setup

---


# minipostiz-cli — Discord Setup

Discord uses webhooks for posting — no OAuth app or bot required. One URL is all you need.

## What you need

| Credential | Flag |
|------------|------|
| Webhook URL | `--webhookUrl` |

---

## Step 1 — Create a Webhook

**In Discord desktop or browser:**

1. Open your server → right-click the target channel → **Edit Channel**
2. Go to **Integrations** → **Webhooks** → **New Webhook**
3. Set a name (e.g. `minipostiz`) and optionally upload an avatar
4. Click **Copy Webhook URL** → save it
5. Click **Save**

**Shortcut:** Channel Settings gear icon → Integrations → Webhooks

---

## Step 2 — Store in minipostiz-cli

```bash
minipostiz auth --platform discord \
  --webhookUrl "https://discord.com/api/webhooks/CHANNEL_ID/TOKEN"

# Or via supercli
sc minipostiz auth set-discord \
  --webhookUrl "https://discord.com/api/webhooks/CHANNEL_ID/TOKEN"
```

---

## Step 3 — Test

```bash
minipostiz auth verify --platform discord
minipostiz publish --platform discord --message "Hello from minipostiz-cli"
```

---

## Multiple channels

To post to multiple Discord channels, use multiple webhook credentials under different platform aliases — or use comma-separated platforms with separate auth entries per server/channel.

---

## Troubleshooting

| Error | Cause | Fix |
|-------|-------|-----|
| `404 Unknown Webhook` | Webhook was deleted | Create a new webhook |
| `401 Invalid Webhook Token` | URL was regenerated | Copy the new URL from channel settings |
| `400 Cannot send empty message` | Empty message string | Ensure `--message` is non-empty |

## Token lifetime

Webhook URLs **do not expire** but can be deleted or regenerated from Channel Settings → Integrations.