Overview

An Inbound Webhook allows external systems to send real-time data or event notifications to SnapApp using HTTP requests.

Instead of SnapApp periodically polling another system for updates, inbound webhooks enable event-driven communication, where external services actively push data to SnapApp whenever something happens.

Inbound webhooks are commonly used in scenarios such as: - Receiving task updates from project management tools (e.g., Asana) - Processing payment notifications from payment gateways - Capturing events from chat platforms or third-party APIs - Triggering workflows instantly based on external events

Table of Contents

• Steps to create an Inbound Webhook
• 1. Navigate to Integrations
• 2. Create a New Integration
• 3. Define the Response Body
• 4. Configure Response Actions (Workflows)
• 5. Enable Request Validation (Optional but Recommended)
  • Require Validation
  • Validation Condition
  • Validation Function
• 6. Save and Activate
• Using SnapApp as a Target Server

Steps to create an Inbound Webhook

Follow the steps below to configure an inbound webhook in SnapApp:

1. Navigate to Integrations

• Click on Settings from the user menu in the top bar.
• From the left navigation, go to Automation → Integrations.

2. Create a New Integration

• Click Add New (+) in the top-right corner.
• Enter a Name for the integration.
• Select Inbound Webhook as the integration type.
• Choose the appropriate Object ID from the dropdown.
• Enable the Active toggle.

3. Define the Response Body

The Response Body determines how incoming webhook data will be mapped to fields in the selected SnapApp object.

• The response body must be provided in JSON format.
• Each key in the JSON should correspond to a field in the selected object.

For example, if your object contains a field named asana_task_id, and the incoming webhook payload includes this value, SnapApp will create a new record with:

asana_task_id = <value received from the webhook request>

You can map multiple fields as long as those fields already exist in the object.

4. Configure Response Actions (Workflows)

• Under Response Actions, click the + icon to attach one or more workflows.
• These workflows will execute automatically whenever the webhook receives a valid request.
• You can also add or modify workflows later from the Webhook Actions section of the webhook details page.

5. Enable Request Validation (Optional but Recommended)

To ensure security and data authenticity, SnapApp supports webhook validation.

Require Validation

• Enable the Require Validation checkbox to validate incoming requests before processing them.

Validation Condition

• Validation conditions define rules that incoming requests must satisfy.
• These conditions help ensure the request is legitimate, properly formatted, and secure.

Example: Allow requests only if they include a specific header:

HEADER:"X-Hook-Secret"

This ensures that only requests containing the correct secret header are accepted.

Validation Function

• A validation function verifies the integrity of the request.
• It is often required by third-party services as part of their security process.

Example (Asana): When configuring an Asana webhook, SnapApp must echo back the same X-Hook-Secret value in the response header to complete Asana’s webhook verification process.

6. Save and Activate

• Click Save to complete the setup.
• Your inbound webhook is now active and continuously listening for incoming notifications.
• Each valid request will:
• Create or update a record in the selected object
• Trigger the configured workflows

Using SnapApp as a Target Server

When configuring a webhook in an external system (such as Asana), you will be asked to provide a target server URL.

Use the following format:

https://<YOUR_SNAPAPP_INSTANCE>.snapapp.com/webhooks/<YOUR_WEBHOOK_ID>

Example

• If :

SnapApp instance = dev >Webhook ID = 1122-3344-5566-7788 >Then the target server URL will be: https://dev.snapapp.com/webhooks/1122-3344-5566-7788

Thank you for following these steps to configure your SnapApp components effectively If you have any questions or need further assistance, please don’t hesitate to reach out to our support team. We’re here to help you make the most out of your SnapApp experience. For support, email us at snapapp@bluevector.ai.