RWS Docs

This guide walks you through creating a working integration that extracts user data from a public API and delivers it to a webhook endpoint. By the end, you’ll understand the core workflow: create Connections, build an Integration, and run it.

What you’ll build

You’ll create an integration that:

Extracts user records from JSONPlaceholder (a free test API)
Transforms the data to a simpler format
Loads the results to webhook.site where you can inspect them

Time required: approximately 5 minutes.

Prerequisites

Access to an RWS Integration Workspace
A web browser

Step 1: Set up your destination

Before building the integration, create a destination endpoint where you can verify the results.

Open webhook.site in a new browser tab
The site automatically generates a unique URL (e.g., https://webhook.site/abc123-def456-...)
Copy this URL; you’ll need it when creating your destination Connection
Keep this tab open to monitor incoming requests

webhook.site is a free service that captures and displays HTTP requests. It’s useful for testing integrations before connecting to real destination systems.

Step 2: Create the source Connection

Connections define how RWS Integration communicates with external systems. You’ll create one for the source API.

In the sidebar, click Connections
Click New Connection
Configure the connection:

Field	Value
Name	`JSONPlaceholder API`
Type	`API`
URL	`https://jsonplaceholder.typicode.com`
Base Path	`/`
Authentication	`No authentication`

Click Save

The JSONPlaceholder API doesn’t require authentication, so the No authentication option (already selected by default for new connections) is all you need.

Step 3: Create the destination Connection

Now create a Connection for your webhook.site destination.

Click New Connection
Configure the connection:

Field	Value
Name	`Webhook Destination`
Type	`API`
URL	`https://webhook.site`
Base Path	`/`
Authentication	`No authentication`

Click Save

Step 4: Create the Integration

With both Connections ready, create the Integration that moves data between them.

In the sidebar, click Integrations
Click New Integration

General settings

Configure the basic integration properties:

Field	Value
Name	`User Sync Quickstart`
Version	`1.0.0`
Type	`Full`
Environment	`Staging`
Schedule	Daily, at a time of your choice (e.g. `09:00`)

The schedule is set with a frequency picker: choose how often the integration runs and fill in the details, like the time of day. See Scheduling for all the options.

Extract phase

The Extract phase retrieves data from your source system.

Expand the Extract section
Configure these fields:

Field	Value
Connection	`JSONPlaceholder API`
Method	`GET`
Path	`/users`

Set the Datapoint Path in Response to root
Set the Pagination:

Field	Value
Pagination Type	`Simple`
Page size parameter	`_limit`
Page size value	`10`
Initial page parameter	`_page`
Initial page value	`1`
Pagination end type	`Object`

Check the Extract Preview panel on the right side. It should show:
- Status: 200 OK
- A single user record (the Datapoint) like this:

{
  "id": 1,
  "name": "Leanne Graham",
  "username": "Bret",
  "email": "Sincere@april.biz",
}

Transform phase

The Transform phase maps source fields to your destination format. For this quickstart, create a simple mapping with three fields.

Expand the Transform section
Click Add Transformation and configure:

Type	To	From
Simple	`userId`	`id`
Simple	`fullName`	`name`
Simple	`emailAddress`	`email`

Check the Transform Preview panel. It should display:

{
  "userId": 1,
  "fullName": "Leanne Graham",
  "emailAddress": "Sincere@april.biz"
}

This confirms your mappings are working correctly with real data from the Extract phase.

Load phase

The Load phase sends transformed data to your destination.

Expand the Load section
Configure these fields:

Field	Value
Connection	`Webhook Destination`
Method	`POST`
Path	Your webhook.site unique path (e.g., `/abc123-def456-...`)
Load Type	`Simple`

Copy only the path portion from your webhook.site URL. If your full URL is https://webhook.site/abc-123, enter /abc-123 as the Path.

Check the Load Preview panel. It shows the complete request that will be sent:
- Path: https://webhook.site/{{ your-unique-path }}
- Method: POST
- Request Body:

{
  "userId": 1,
  "fullName": "Leanne Graham",
  "emailAddress": "Sincere@april.biz"
}

Step 5: Deploy the Integration

Toggle Deployment to enabled
Click Create Integration

The integration will now run automatically every day at the time you chose.

Step 6: Run it now

You don’t need to wait for the schedule. Trigger the first run manually:

Open your integration from the Integrations list
Click Run now, next to the Save button
Confirm in the dialog, and a Run started message appears

Step 7: Verify the results

Switch to your webhook.site browser tab. You should see 10 incoming POST requests (one for each user from JSONPlaceholder), each containing your transformed data structure:

{
  "userId": 1,
  "fullName": "Leanne Graham",
  "emailAddress": "Sincere@april.biz"
}

Congratulations, you’ve built and run your first integration!

What you learned

Connections store configuration for external systems and can be reused across multiple Integrations
Integrations follow the Extract → Transform → Load pattern (with optional Enrichment)
The Datapoint Path tells RWS Integration where to find records in API responses
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
Environments (Staging/Production) let you safely test before deploying to production
Run now triggers a run on demand, without waiting for the schedule

Next steps

Connections

Learn about different authentication methods

Pagination

Handle pagination and complex API responses

Business Rules

Master field transformations with JavaScript

Scheduling

Schedule your integrations to run automatically

Getting Started

Guides

Core Concepts

Quickstart

What you’ll build

Prerequisites

Step 1: Set up your destination

Step 2: Create the source Connection

Step 3: Create the destination Connection

Step 4: Create the Integration

General settings

Extract phase

Transform phase

Load phase

Step 5: Deploy the Integration

Step 6: Run it now

Step 7: Verify the results

What you learned

Next steps

Connections

Pagination

Business Rules

Scheduling

​What you’ll build

​Prerequisites

​Step 1: Set up your destination

​Step 2: Create the source Connection

​Step 3: Create the destination Connection

​Step 4: Create the Integration

​General settings

​Extract phase

​Transform phase

​Load phase

​Step 5: Deploy the Integration

​Step 6: Run it now

​Step 7: Verify the results

​What you learned

​Next steps

Connections

Pagination

Business Rules

Scheduling

What you’ll build

Prerequisites

Step 1: Set up your destination

Step 2: Create the source Connection

Step 3: Create the destination Connection

Step 4: Create the Integration

General settings

Extract phase

Transform phase

Load phase

Step 5: Deploy the Integration

Step 6: Run it now

Step 7: Verify the results

What you learned

Next steps