Button webhooks

​

Prerequisites

• Understanding of Interactive buttons
• An external webhook URL (or a test service like webhook.site)
• Basic knowledge of HTTP and JSON

​

How it works

1. User clicks a button in Slack
2. LithoBlocks receives the interaction
3. Your webhook payload is compiled with interaction data
4. An HTTP request is sent to your endpoint
5. Your system processes the request

​

Quick start

​

Step 1: Create a webhook destination

1. Go to Webhooks in the sidebar
2. Click Create Webhook Destination
3. Set Name (e.g. “Approval API”), URL (e.g. https://api.yourcompany.com/approvals), and Method (e.g. POST)
4. Add headers if needed (e.g. Authorization: Bearer YOUR_API_KEY, Content-Type: application/json)

​

Step 2: Define the payload

{
  "action": "approve",
  "request_id": "{{interaction.action_value}}",
  "approved_by": "{{user.id}}",
  "timestamp": "{{system.timestamp}}"
}

​

Step 3: Connect the button

1. Open your template and select the button
2. In button settings, click Add Action → Webhook
3. Select your webhook destination
4. Save the template

​

Step 4: Test

1. Send the template to a test channel
2. Click the button
3. Check Usage → Interactions for webhook logs
4. Confirm your API received the request

​

Authentication

• Bearer: Authorization: Bearer YOUR_RECEIVER_TOKEN
• API key: X-API-Key: your-api-key
• Basic: Authorization: Basic base64(username:password)

​

Webhook usage in templates

​

Next steps