REST API integration

Connect any system to Fin with a custom REST API data connector


Overview

Fin's REST API connector lets you integrate any internal or external system, giving Fin access to proprietary data sources with no off-the-shelf connector required.

On Intercom, you set up the REST API connection in the same workspace as your Helpdesk inbox, tickets, and reporting, and Fin hands off to your team there with the full conversation.

What you can do

  • Connect to any REST endpoint with token-based or OAuth authentication (OAuth in beta)
  • Configure request parameters, headers, and response field mapping
  • Map and transform fields from nested response structures
  • Use custom API data in Fin conversations, Workflows, and Procedures
  • Requires JWT or email OTP user authentication for live use in production

How it works

Go to Fin AI Agent → Train → Tasks → Manage Data connectors and create a custom connector for REST API, or start from an AI recommendation.

Set up the API call to your REST API system. Configure request parameters, authentication (token-based or OAuth), and map the response fields Fin should use.

Data connectors require JWT or email OTP user authentication to go live. Connectors can only be fully tested in production, not in test workspaces.

Configure

Works with Fin through an API Data connector, supporting both read and write operations. Fin can fetch data to personalize answers and execute actions like processing refunds, updating accounts, or modifying subscriptions in connected systems.

Read the full setup documentation →