---
title: "App Webhooks"
description: ""
icon: 'webhook'
---

Certain apps like Slack and Square only support one webhook per OAuth2 app. This means that manual configuration is required in their developer portal, and it cannot be automated.

## Slack

**Configure Webhook Secret**

1. Visit the "Basic Information" section of your Slack OAuth settings.
2. Copy the "Signing Secret" and save it.
3. Set the following environment variable in your activepieces environment: 
    ```
    AP_APP_WEBHOOK_SECRETS={"@activepieces/piece-slack": {"webhookSecret": "SIGNING_SECRET"}}
    ```
4. Restart your application instance.


**Configure Webhook URL**

1. Go to the "Event Subscription" settings in the Slack OAuth2 developer platform.
2. The URL format should be: `https://YOUR_AP_INSTANCE/api/v1/app-events/slack`.
3. When connecting to Slack, use your OAuth2 credentials or update the OAuth2 app details from the admin console (in platform plans).
4. Add the following events to the app:
    - `message.channels`
    - `reaction_added`
    - `message.im`
    - `message.groups`
    - `message.mpim`
    - `app_mention`
    - `channel_created`
    - `reaction_removed`
    - `star_added`
    - `team_join`
    - `emoji_changed`

<Warning>
Turn **Socket Mode off** for your Slack app (under **Settings → Socket Mode**). While Socket Mode is on, Slack delivers events over a WebSocket connection and never POSTs to the Request URL (`https://YOUR_AP_INSTANCE/api/v1/app-events/slack`), so the trigger silently never fires.
</Warning>

**Configure Interactivity & Shortcuts**

Needed for the "New Modal Interaction" trigger and the "Request Approval"/"Request Action" actions (their buttons resume the flow via this URL).

1. Go to the "Interactivity & Shortcuts" settings in the Slack OAuth2 developer platform.
2. Turn interactivity on.
3. Set the Request URL to the same URL used above: `https://YOUR_AP_INSTANCE/api/v1/app-events/slack`.
