Skip to main content
Nango publishes function templates for the most popular APIs and use cases. Function templates are a starting point for your custom integrations to reuse and extend. You can find thousands of function templates on the templates GitHub repo. This guide walks you through how you can extend and customize them.

​
How to extend a function template

​
Step 1 - Initial Functions setup

If you don’t have a nango-integrations folder yet, follow the initial Functions setup guide first. Otherwise, you can skip to the next step.

​
Step 2 - Download the function template code

Use the CLI to clone the integration template. You can clone an entire integration folder (e.g. github), subfolders with a specific type of functions (e.g. github/actions) or individual functions (e.g. github/actions/list-repos action). The CLI will make sure to also clone all the other files that are imported in the cloned files. 
nango clone github                              # Clones an entire github integration folder
nango clone github/actions                      # Clones all github actions
nango clone github/actions/list-repos           # Clones just the list-repos action
You can also download the integration template files manually from our integration templates GitHub repo. If you do that, make sure to also copy imported functions that may be in other files and import the new files in your index.ts file.

​
Step 3 - Customize the template

Edit the sync and action functions as required for your integration. You may want to reference: These two guides explain the SDK available in custom sync and action functions. They also explain how to test your functions locally and how to deploy them.
If a custom sync or action function name conflicts with a function template name, the custom function 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.