Integration with Webhook Trigger

​

What you’ll build

1. Extracts data from incoming webhook requests
2. Transforms the data by mapping fields to your destination format
3. Loads the transformed results to webhook.site where you can inspect them

​

Prerequisites

• Access to an RWS Integration Workspace
• A web browser
• cURL (or similar command-line tool) for triggering the webhook

​

Step 1: Create the webhook connection

1. In the sidebar, click Connections
2. Click New Connection
3. Configure the connection:

4. Click Save
5. Copy the connection ID; you can find it in the URL after creating the connection. You’ll need this ID when triggering the webhook with cURL.

​

Step 2: Create the destination connection

1. Click New Connection
2. Configure the connection:

3. Click Save

​

Step 3: Set up your destination

1. Open webhook.site in a new browser tab
2. The site automatically generates a unique URL (e.g., https://webhook.site/abc123-def456-...)
3. Copy the unique path portion (e.g., /abc123-def456-...); you’ll need it when configuring the Load phase
4. Keep this tab open to monitor incoming requests

​

Step 4: Create the Integration

1. In the sidebar, click Integrations
2. Click New Integration

​

General settings

​

Extract phase

1. Expand the Extract section
2. Configure these fields:

3. The webhook will accept incoming POST requests with JSON payloads. You can add a sample body to the Extract Preview panel to make it available for transformation and load previewing in the next phases:

{
  "id": "1234567890",
  "description": "Item description"
}

​

Transform phase

1. Expand the Transform section
2. Click Add Transformation and configure:

3. Check the Transform Preview panel. It should display the transformed structure based on sample data:

{
  "externalId": "1234567890",
  "itemDescription": "Item description"
}

​

Load phase

1. Expand the Load section
2. Configure these fields:

3. Check the Load Preview panel. It shows the complete request that will be sent:
   • Path: Full destination URL
   • Method: POST
   • Request Body: Your transformed data structure

​

Step 5: Deploy the Integration

1. Toggle Deployment to enabled
2. Click Create Integration

​

Step 6: Trigger and verify the integration

• {{ tenantId }} - Your organization’s tenant ID (you can find it in the URL of the RWS Integration workspace)
• {{ webhookId }} - The webhook connection ID from Step 1 (you can find it in the URL of the webhook connection page)
• {{ apiKey }} - Your API key for RWS Integration (contact the RWS Integration team if needed)

curl -X POST "https://api.rwsintegration.com/v1/webhook?tenantId={{ tenantId }}&webhookId={{ webhookId }}" \
  -H "x-api-key: {{ apiKey }}" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "1234567890",
    "description": "Item description"
  }'

{
  "success": true,
  "message": "1 jobs queued for 1 integrations",
  "jobIds": [
    "1234567890"
  ],
  "integrationCount": 1
}

{
  "externalId": "1234567890",
  "itemDescription": "Item description"
}

​

Asynchronous delivery

curl -X POST "https://api.rwsintegration.com/v1/webhook?tenantId={{ tenantId }}&webhookId={{ webhookId }}&async=true" \
  -H "x-api-key: {{ apiKey }}" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "1234567890",
    "description": "Item description"
  }'

{
  "success": true,
  "message": "Webhook accepted for asynchronous processing"
}

​

What you learned

• Integrations follow the Extract → Transform → Load pattern (with optional Enrichment)
• Webhook connections receive incoming requests rather than making outbound API calls
• Preview panels automatically update as you configure each phase, letting you validate before running
• Simple transformations map fields from source to destination using JSONPath notation
• How to trigger the webhook integration with a cURL POST request
• Delivery modes: synchronous by default, or asynchronous with async=true for providers with short timeouts

​

Next steps