Custom integrations

Introduction

Custom Integrations allow Rewst users to build their own integrations tailored specifically to their organization's needs. Integrate workflows with any service that exposes an API, enhancing automation and efficiency within your operations.

Currently, there is documentation for both V1 and V2 of Rewst's custom integrations on this site. All new custom integrations should be set up using the method for V2. V1 documentation remains to assist existing customers with their migration from V1 to V2.

Why use custom integrations?

• Flexibility: Build integrations that are perfectly tailored to your unique automations requirements.

• Compatibility: Supports both modern and legacy APIs by accepting Swagger, OpenAPI specifications, or building your own integration from scratch.

• Ease of use: Automatically generate actions from API definitions, which can be used in workflows without manual coding.

• Visibility control: Manage who in your organization or in sub-organizations can see and use the integrations.

• Lifecycle management: Easily manage the lifecycle of your integrations with statuses like draft, published, deprecated, and hidden.

How to use custom integrations

Enable custom integrations in your Rewst instance

Custom integrations can only be enabled by users with the Rewst Admin role.

1. Navigate to Settings > Feature Preview in the right side menu of your Rewst platform.

2. Click Custom Integrations V2.

3. Click Enable. A green confirmation message will appear at the top of your screen.

4. Whenever you wish, you may click Disable to turn off the custom integrations functionality for your instance, from this same menu.

The custom integrations screen

Supported schemas

Supported authorization schemas

• None

• API key

• Basic authorization

• OAuth 2.0 with the following grant types

• Client Credentials

• Authorization code

• No grant type

Supported pagination schemas

Edit and manage integrations

Once an integration is created, you can edit it by navigating to the integration's detail page. Here, you can:

• Change the visibility status of the integration (Hidden or Published).

• Modify existing actions or add new actions or mark them as deprecated.

• Delete the integration (Note: The integration must be uninstalled from all sub-organizations first).

Use custom integrations in workflows

After creating and configuring your integration, you can use it in workflows by adding actions from your custom integration to the workflow.