#Quickstart Guide
Here is a quick summary of steps to help you integrate with Setu’s Insights API. Before you start, there are some key terms that will be referred to periodically in the documentation—
- Reference Id—Developers can define an identifier to manage and track one customer's data points. This identifier is used throughout the lifecycle to push data, generate insights and finally purge any data from the system.
- FI Data block—FI Data blocks are the data received from the FIP (Financial information provider), via the AA. Currently, we support bank statement, equities, mutual_fund and etf datablocks. In addition, we support ePDF-based bank statements for Indian banks.
- Template—A template is a pre-configured format that determines the structure of the generated report, including which insights to generate. You can pick and choose exactly what insights should be added to a template, based on your needs.
For example, if you only want to generate income and expense insights of a customer, the template can contain only those two insights.
Please refer to the Account Aggregator's quickstart guide for key terms related to AA
#Step 1—Create a template
You can create a template either by contacting Setu, or directly via API.
#Option 1: Email template details
Send the following details to insights@setu.co —
Field | Description |
---|---|
FIU ID | Obtained from your AA integration |
Notification endpoint | An endpoint where Setu will send you webhook notifications for events. See notifications. |
Template name | Choose a suitable name, which helps you easily recognise this template |
Use case | Sharing your use case will help us guide you with finalizing relevant insights. Typical use cases, Loan Underwriting, F&O, Portfolio Management, Personal Finance Management, etc. |
Insights required | A list of required Insights. Send an email to insights@setu.co for full list of insights. |
Output format | Format in which you need the output — currently we support JSON , and XLSX . |
#Option 2: Use API to create/update template
You can create (POST /v2/template
) or update (PUT /v2/template
) templates via API. See API Integration for details.
Setu will respond with a templateId
, which is required to generate insight reports.
#Step 2—Ingest data
Once you have the user’s financial data, you can push it to Setu Insights using:
- AA-sourced JSON – Use
/v2/fiData
- Bank PDF statements – Use
/v2/pdf-ingest
for PDF uploads
Use a single refId
per customer. See the API Integration section for details.
#Step 3—Generate insights
You can generate insights for each customer that is created in the previous step. To generate insights, pass the templateId
and refId
from the previous steps.
Use the templateId
and refId
to generate insights with the /v2/report
API.
- You’ll receive a
reportId
in response - Insights will be sent to your webhook URL
- You can fetch reports later using this
reportId
- Refer API integration to integrate with Insight generation APIs.
#Step 4 — (Optional) Purge Customer Data
You can delete a customer’s data from Setu using the refId
via the /v2/purge
API. This is useful for meeting data minimization and regulatory compliance requirements such as user data deletion requests under privacy laws.
When a purge is triggered:
- All Financial Information (FI) data retrieved for the user is permanently deleted.
- All insights generated from this FI data—such as income summaries, categorized transactions, and financial behavior indicators—are also removed.
See the API Integration section for more details on how to use this endpoint.
#Test on Postman or integrate APIs
ON POSTMAN
Set up Postman environment ->FOR API INTEGRATION
Start API integration ->Was this page helpful?