Custom integrations (v2)
Last updated
Was this helpful?
Last updated
Was this helpful?
This Integration supports multiple instances
Check out our instructions to set up multiple instances here.
This guide will walk you through the steps to add a custom integration in Rewst.
Navigate to Configuration > Integrations in the left side menu of your Rewst platform.
Click Add New Integration.
Click New Integration to build your integration from the beginning.
Alternatively, click Add OpenAPI Integration if you have a JSON file that follows the OpenAPI or Swagger specification.
Note that Rewst will automatically convert Swagger to OpenAPI if necessary, and validate the API specification using the vacuum linting tool. Currently, only JSON files are accepted, not YAML.
Click Submit. Once you upload your file and there are no validation errors, you can start configuring your integration.
Specify your configuration details, then click Next.
Add a Name for your integration.
Upload an Icon via an SVG file. Other image file formats will not upload into Rewst.
Add a Description.
Choose your authentication method, then click Next.
Add the hostname without https:// at the beginning of your URL.
Choose an authentication method. Rewst supports:
API Key
Basic Auth
OAuth 2.0 (Authorization code, Client Credentials, or no grant type)
No Auth
Fill out the authentication defaults, then click Next.
Depending on the authentication method you chose, you'll be presented with a form to fill out the details of the integration's authentication.
Select a pagination method, then click Next.
Select your Pagination Type from the drop down menu:
No pagination
Index
Page
Link
Pointer
Fill out the pagination details, then click Next.
Depending on the pagination method you chose, you'll be presented with a form to fill out the details of the integration's pagination.
Edit your actions, then click Finalize.
Create, update, or delete the actions and their parameters.
Click Finalize again.
An optional step is to update the status of your integration. Select a status from the status list:
Draft: The integration is not finalized, can be still be edited, but not installed. Once an integration is finalized it can't be put back in to draft mode.
Published: The integration will be installable by your organizations and all sub organizations.
Hidden: The integration is not installable by your organizations and all sub organizations, but can be edited.
