API Reference

Register a Webhook

Verify and register a Discord incoming webhook.

POST/webhooks

JSON Body

Use discord.com or discordapp.com. Republic normalizes supported URLs to Discord's v10 API. Custom hosts, redirects, and arbitrary query parameters are unsupported. The same webhook and thread can be registered only once per account. Verification does not send a message.

labelstring, required: Name, 1 to 80 characters.
urlstring, required: Discord incoming-webhook HTTPS URL, optionally with numeric thread_id.

Request

cURL

curl -X POST 'https://dev.republicrx.app/api/developer/v1/webhooks' \
  -H "Authorization: Bearer $REPUBLIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"label":"Newsroom","url":"YOUR_DISCORD_WEBHOOK_URL"}'

Response

HTTP 201. Use data.id for subscriptions and updates. The complete URL is encrypted at rest and is not returned.

json

{
  "data": {
    "id": "00000000-0000-4000-8000-000000000001"
  }
}