Webhook & Gateway Integration

Interactions Endpoint URL

Configure an interactions endpoint to receive interactions via HTTP POSTs rather than over Gateway with a bot user.

1. Your Production Endpoint URL

Use the following URL in your Discord Application Developer Portal under General Information > Interactions Endpoint URL:

https://api.authsetu.com/api/v1/discord/interactions

2. How Verification Works (Ed25519)

When you input your endpoint URL into developer portals, a verification request is automatically dispatched:

  • PING Check (Type 1): Discord sends an HTTP POST body with { "type": 1 }.
  • PONG Response (Type 1): AuthSetu verifies request headers (X-Signature-Ed25519 and X-Signature-Timestamp) and responds instantly with { "type": 1 }.
  • Status: HTTP 200 OK confirms successful endpoint validation.

3. Supported Interaction Payloads

Once verified, your endpoint handles application slash commands, button component clicks, select menu interactions, and modal submissions seamlessly.