Extend a pre-built integration
Guide on how to extend a pre-built integration in Nango.
Nango publishes pre-built integrations for the most popular APIs & use cases. Pre-built integrations are a starting point for your custom integrations to reuse and extend.
Here is the list of publicly available pre-built integrations.
If you want to edit their code or configuration, you must pull them in your integration folder.
Pre-requisite: set up the CLI and integration folder.
Download the template code
Download the template code locally. The code is available on GitHub or directly in the Nango UI in the Endpoints tab of an integration.
Copy/paste the integration configuration & scripts
Copy/paste the necessary configuration from the nango.yaml
file of the template folder into your own nango.yaml
configuration (in your nango-integrations
folder).
Copy/paste the necessary integration script files (ending in .ts
) from the template folder into your nango-integrations
folder.
There is no need to copy/paste the models.ts
file from the template folder; it is a generated file that will be regenerated separately in your integrations folder when you run nango dev
.
Customize the template at will
Edit the nango.yaml
configuration and integration scripts as you see fit (guide).
If a custom integration script name conflicts with a template name, the custom integration script will override the template in the Nango UI (once you deploy your custom integrations to Nango).
Questions, problems, feedback? Please reach out in the Slack community.
Was this page helpful?