Releases: NangoHQ/nango
v0.35.5 - Pagination helper & many improvements
✨ New Features
# | Title | Issue/PR | Description |
---|---|---|---|
1 | Pagination helper | #856 | Script the pagination code in your custom integration scripts. |
2 | Faster Activity tab | #1121 | It took a long time to load with significant traffic, now 10x faster. |
3 | Records filtering | #1170 | Filter records by created/updated/deleted |
4 | Auth modal close | #571 | The auth modal returns an error when the end-user interrupts the auth flow. |
5 | Sync run time | #991 | The dashboard now shows script run time (latest run + 30d accumulated runs) |
6 | Sync status endpoint | #1081 | Get the status of a sync (running, success, failure, paused) |
7 | Actions improvements | #1091 #1156 #1025 | Better logging & error reporting for actions |
8 | List syncs & actions | #1120, #1109 | Endpoint to return available syncs & actions |
9 | Webhook improvement | #1134 | Option to send a webhook when syncs complete without delta (enable in Project Settings) |
10 | Integration details | #1072 | Specify details about your integrations (required scopes, etc.) |
11 | Frontend SDK improvement | #1154 | The Frontend SDK now exports AuthError and AuthResult . |
12 | Unauthenticated integrations | #1014 | Added support for integrations that do not require authentication (e.g. scrapping). |
🔌 New APIs & Integrations
# | Issue/PR | Description |
---|---|---|
1 | #1139 | Gong API |
2 | #1146 | Sendgrid API |
3 | #1071 | GitHub Apps |
4 | #1065 | Hubspot Knowledge Base integration |
5 | #1069 | Salesforce Service Cloud Ticket integration |
🐞 Bug Fixes
# | Issue/PR | Description |
---|---|---|
1 | #693 | Some APIs returned encoded responses. |
2 | #1094 | Track deletes problem. |
3 | #1104 | Fix npm audit warnings. |
4 | #1110 | Connection creation form doesn't expose dynamic fields. |
5 | #1138 | Activity log deep linking doesn't work. |
v0.33.0 - Pre-built integrations, managed integrations
🚨 Breaking changes
Title | Issue/PR | Description | |
---|---|---|---|
1 | Proxy: Backfill Base URLs | #1059 | Backfilled many API base URLs. Some were modified: FreshService, Pannylane, RingCentral, Sage, Evaluagent. |
✨ New Features
# | Title | Issue/PR | Description |
---|---|---|---|
1 | Pre-built integrations | #983 | Activate public syncs & actions directly from the dashboard with just a few clicks. |
2 | Managed integrations | #983 | Let Nango implement and deploy custom integrations directly to your account. |
3 | Key Rotation | #488 | Introduce the option to rotate both secret and public keys for enhanced security. |
4 | In-Dashboard Scripts | #841 | Access and download sync/action scripts directly from the dashboard. |
5 | Enhanced Action Tooling | #993 | Introducing the dedicated NangoAction interface for action scripts. |
6 | App Version Display | #841 | View the Nango app version in the 'Project Settings' section of the dashboard. |
7 | Instant Sync Start | #1036 | Initiate a sync immediately, without waiting for the next scheduled run. |
8 | Optional Action Return Model | #1009 | Simplify actions without outputs – no return model specification required. |
9 | Slack Webhook Capture | #1026 | Securely capture webhook URL metadata during the OAuth process. |
10 | OAuth Parameter Override | #1040 | Easily override pre-set OAuth parameters from the frontend SDK as needed. |
11 | New API: Highlevel | #1057 |
🐞 Bug Fixes
# | Issue/PR | Description |
---|---|---|
1 | #963 | Fixed scheduling issues with Nango Sync. |
2 | #953 | Resolved layout disruption caused by lengthy connection IDs. |
3 | #1032 | Disabled the auto-fill option for environment variables. |
4 | #1060 | Corrected token introspection for Salesforce sandbox. |
5 | #1061 | Addressed the issue where sync deploy activity log messages appeared empty. |
6 | #1016 | Fixed intermittent failures related to token refresh/validity. |
7 | #1027 | Resolved the issue blocking environment variable deletion when it's the only one present. |
v0.32.8 - Secrets, sync management
✨ New features
Title | Issue/PR | Description | |
---|---|---|---|
1 | Secrets in scripts | #763 | Define secrets on the dashboard, accessible in scripts, encrypted at rest |
2 | Better sync management | #990 | Start & pause syncs, store attributes at the sync level |
3 | Delete improvements | #975 | Metadata on each record indicating if deleted or not, delete count in webhooks |
4 | Sync initial state | #992 | Settings for starting/pausing syncs by default in nango.yaml |
5 | Webhook improvements | #994, #687 | Webhook retries + no webhook timestamp on initial sync |
🐞 Bug fixes
Issue/PR | Description | |
---|---|---|
1 | #1010 | Disable autofill in integration settings. |
2 | #1003 | Fix manual token refresh from dashboard. |
v0.31.5 - Actions, deletes, rate-limits
✨ New features
Title | Issue/PR | Description | |
---|---|---|---|
1 | Actions | #962 | Perform one-off synchronous actions to encapsulate complex workflows |
2 | Deletes | #909 | Detect soft deleted records for both incremental and full refresh syncs |
3 | API-specific rate-limits | #857 | Observe rate-limit headers to wait until next request (Discord/Github as examples) |
4 | CommonJS/ESM dual build | #959 | Backend Node SDK is now compatible with CommonJS, in additional to ESM |
5 | New Salesforce templates | #958 | Added support of syncing opportunities (+ cleaned up accounts & contacts templates) |
6 | Improve Microsoft support | #951 | Ask for permissions again when users re-auth Microsoft (O365, Teams, Azure, etc.) |
7 | Use Datadog for monitoring | #971 | Change from Sentry to Datadog for logs to improve querying capabiltiies |
8 | Sync tab improvements | #714 | Improve readability & naming |
9 | Added Aircall API | #978 | |
10 | Added ServiceM8 API | #978 | |
11 | Added Pennylane API | #946 | |
12 | Added ServiceM8 API | #947 |
🐞 Bug fixes
Issue/PR | Description | |
---|---|---|
1 | #949 | Importing connections would cause an error because of unknown integration. |
2 | #950 | Proxy docs were inaccurate to forward custom headers. |
3 | #954 | Importing connections with metadata would not work properly. |
4 | #918 | No longer required to return from fetchData function in syncs. |
v0.29.0 - New APIs & templates
✨ New features
Title | Issue/PR | Description | |
---|---|---|---|
1 | New API: FreshService | #922 | Contribute of @ajtrichards |
2 | New API: Ring Central | #923 | Contribution of @ajtrichards |
3 | New API: Eventbrite | #926 | |
4 | New templates: Hubspot tickets, owners, users | #924 #938 | Contribute of @ajtrichards |
5 | New templates: Confluence pages, spaces | #928 | Contribution of @ha-sante |
6 | New templates: Zendesk tickets, articles | #937 | Contribution of @ha-sante |
🐞 Bug fixes
Issue/PR | Description | |
---|---|---|
1 | #941 | Fix Node SDK compilation due to field mapping type |
v0.28.1 - Multiple users & per-record added/updated metadata
🚨 Breaking changes
Title | Issue/PR | Description | |
---|---|---|---|
1 | UPCOMING: nango.batchSend is deprecated |
#764 | Use batchSave instead (drop-in replacement). batchSend will be removed with a future release. |
2 | UPCOMING: returning data at the end of fetchData is deprecated |
#764 | Use await batchSave() instead. See Sync data guide. |
3 | Two parameters changed in /sync/records REST API |
#893 | The recently introduced sortBy parameter is now sort_by and the values have also changed to snake case. See docs |
Please reach out if you need help migrating your Sync scripts!
✨ New features
Title | Issue/PR | Description | |
---|---|---|---|
1 | Multiple users in same account | #874 | On Nango Cloud you can now collaborate with multiple users on the same account |
2 | Get per-record metadata | #893 | Nango can now tell you per record which have been added or updated with the last sync. See docs for details |
3 | Request retries on timeouts | #907 | The nango proxy now automatically retries requests that time out (respecting the retries you set) |
4 | Request retries on network issues | #887 | The nango proxy now automatically retries requests that experience network issues (respecting the retries you set) |
5 | Trigger individual one-off syncs | #891 | When triggering syncs for one-off runs with the API or SDK, you can now specify which syncs should run (see docs) |
6 | Types for metadata | #898 | You can now type your metadata for better type safety |
🐞 Bug fixes
Issue/PR | Description | |
---|---|---|
1 | #908 | Fixed a bug with connection configs not being properly inserted |
2 | #896 | Fixed an issue where sometimes an incremental sync would start, even if an initial sync had not yet finished |
3 | #902 | Fixed a small bug which could cause sync scripts compilation to fail unnecessarily |
v0.27.0 - Custom Metadata & records sort
🚨 Breaking changes
Title | Issue/PR | Description | |
---|---|---|---|
1 | Connection metadata consolidation | #874 | We changed how metadata is stored for Connections. |
✨ New features
Title | Issue/PR | Description | |
---|---|---|---|
1 | Store custom metadata on Connections | #874 | You can now store any custom metadata on a Connection |
2 | Integration templates | #854 | Nango now has Integration templates for many popular use-cases |
3 | Specify sort of getRecords | #842 | You can now tell Nango the sort order of getRecords (see docs) |
4 | Run compilation before nango dryrun |
#867 | Nango will now auto compile your syncs every time you run nango dryrun |
5 | Better sync error reporting | #865 | If you return multiple records with the same id Nango now reports errors better |
6 | Delete connection from node SDK | #825 | You can now delete a connection from the node SDK |
7 | Types for node SDK & frontend SDK | #366 | The node SDK & frontend SDK now have fully typed return values |
8 | Better environment switching | #769 | The environment dropdown in the navigation bar is now smarter |
9 | Faster Activity tab load | #834 | The activity tab in the Nango dashboard now loads faster |
🐞 Bug fixes
Issue/PR | Description | |
---|---|---|
1 | #877 | Resolved a bug that prevented deleting of integrations |
2 | #866 | Fixed a bug with the callback URL on self-hosted instances |
3 | #752 | lastSyncDate is now the start of the last sync (instead of the end) |
4 | #847 | Syncs are now properly deleted when an integration or connection is deleted |
5 | #852 | More space in the DB for long scopes |
6 | #753 | Fixed an issue where some connections would not get syncs added as they should |
7 | #791 | Fixed an issue which could lead to duplicate db sync entries (though they were harmless) |
8 | #809 | Credentials in the dev environment are now also properly encrypted |
9 | #820 | The password in the Basic auth authentication method is now optional |
10 | #822 | We now properly detect connection configuration parameters in the proxy URL |
11 | #832 | In some cases scopes were not properly stored for new Integrations |
12 | #838 | Fixed some links to docs from the dashboard |
API key support
🚨 Breaking changes
Title | Issue/PR | Description | |
---|---|---|---|
1 | providers.yaml schema |
#322 | Proxy-related fields are now nested under the proxy field. |
✨ New features
Title | Issue/PR | Description | |
---|---|---|---|
1 | API keys | #322 | Support API keys and Basic auth to authorize APIs. |
2 | Unit tests | #273 | Add unit tests to Nango (about 30 so far) |
3 | Mixpanel | #608 | Added support for the Mixpanel API. |
4 | Amplitude | #609 | Added support for the Amplitude API. |
5 | Gong | #826 | Added support for the Gong API. |
6 | Ashby | #826 | Added support for the Ashby API. |
7 | Workable | #826 | Added support for the Workable API. |
8 | Shortcut | #322 | Added support for the Shortcut API. |
9 | Zoho | #814 | Added support for Zoho's various API (Books, Invoices, Inventory, CRM, etc.). |
10 | init command |
#815 | The nango init command now generates a fully-functional Github integration example. |
11 | Dynamic proxy URLs | #816 | Support string interpolation in Proxy base URLs, using the connection configuration |
12 | Error handling | #783, #750 | Improve error handling, particularly for external API errors. |
13 | Windows compatibility | #788 | Make the Nango CLI compatible with Windows |
🐞 Bug fixes
Issue/PR | Description | |
---|---|---|
1 | #804 | Remove notion2 test integration. |
2 | #715 | Prevent syncs from re-ordering when paused. |
3 | #716 | Prevent triggering syncs from logging twice in the Activity tab. |
4 | #766 | Fix Activity tab log links (broken by the introduction of environments). |
5 | #720 | Fix bug where the next sync time was unreliable. |
6 | #761 | Connection raw field has the wrong type. |
Data syncing
🚨 7 breaking changes (+ 4 self-hosted only)
1 - Global CLI installation (#740)
The Nango CLI should now be installed globally by running npm install nango -g
(docs). Running CLI commands should no longer require npx
or npm
(e.g. nango generate
instead of npx nango generate
).
2 - Cloud-first developer experience (#760)
You no longer need to run Nango locally. In practice, you no longer have to run nango start
and nango dev
no longer runs Nango locally (simply watches and compiles your integrations files).
3 - Where to run CLI commands from (#760)
The Nango CLI commands should now be run from the ./nango-integrations
folder (instead of one level above), except for the init
command which creates the ./nango-integrations
folder. As a result, your CLI .env
file should be located inside the ./nango-integrations
folder (instead of one level above).
4 - Environment keys (#760)
With the introduction of environments (dev
and prod
), you will now have multiple secret and public keys (cf. docs). The name of the corresponding environment variables has been changes to:
NANGO_SECRET_KEY_PROD='<prod-secret-key>'
NANGO_SECRET_KEY_DEV='<dev-secret-key>'
5 - CLI commands (#760)
CLI commands have changed (run nango
to see the full list of commands), in particular:
sync:run|sr
has becomedryrun
(arguments have changed)deploy
takes an additional "environement" argument (dev
orprod
)- unnecessary commands have been removed
6 - NANGO_HOSTPORT
env var (#760)
By default the NANGO_HOSTPORT
CLI env variable is no longer required (unless if you are using OSS).
7 - Deletes previous Activity logs (#734) & sync runs info
Due to changes in the DB schema for Activity logs & sync runs (introduced by dev environments), the Activity logs & sync runs schema migration would cause too much down time. As a result, Activity logs & sync runs previous to the migration will be dropped. The information about syncs might be missing for the time between the release and your next sync run.
Self-hosted 1 - Required public key (#760)
The Frontend SDK Nango
constructor now requires a publicKey
in all cases. You can find your automatically-generated public key in the dashboard's Project Settings (docs).
Self-hosted 2 - Required private key (#760)
The Backend Node SDK Nango
constructor now requires a secretKey
in all cases. You can find your automatically-generated secret key in the dashboard's Project Settings (docs).
Self-hosted 3 - No Basic auth (#760)
The OSS version no longer uses Basic auth. Similarly to cloud, It uses Bearer headers for authentication. This is handled for you if you use the Backend Node SDK and CLI. Changes are required if you use the REST API (docs).
Self-hosted 4 - .env settings moved to the dashboard
The callback URL & HMAC settings were moved from the env variables to the Nango dashboard (in the Project Settings tab). They are specific to a given environment (dev
vs prod
).
Other features in this release
- Syncs tab + Syncs-related Activities (#712)
- Re-sync a connection in UI + API
- Perform dry runs of syncs with the CLI
- Return data in batches for large datasets in sync scripts
- Field mapping
- Model features (inheritance, nested ojects, array type)
- Webbooks when syncs complete
- Connection-specific auth params (#735)
- Logs in sync scripts
- Auto-update CLI
- Slack-specific user scopes
- Cloud-first DX (cf Quickstart) + simplified CLI
- Align OSS Project Settings on Cloud
- HMAC for cloud
- Dev environments
- Improved docs
- Auth with a link
- Fetch integrations creds from API (#685)
- Configurable websocket path for OSS (#677)
- New integrations: Netsuite, Gumroad, SurveyMonkey, Google Docs
- Pagination on the activity tab
- Import external OAuth creds in Nango with API
- Use the Proxy, even if the base URL is not configured
- Activity tab logs formatting & link to individual activity (#610)
- Listing running syncs on Connection page
- Deployment of syncs to cloud/nango with versioning
- Sync pause/start
- Custom buffer for refreshing tokens (#748)
- Use a link to trigger an OAuth flow (#603)
- Make the backend Node SDK compatible with NextJS, NestJS and Remix (#710)
v0.16.0 (Many improvements)
May 1, 2023
Hi everyone,
This weeks release (v0.16.0
) comes with many improvements:
- Nango Proxy: configurable retries & exponential backoff (🙏 @khaliq Gant)
- Force refresh tokens on the [API](#465) & [dashboard](#544) (🙏 @chakravarthi)
- [Secure frontend requests](#582) with HMAC keys (🙏 @simon Stone)
- Support integrations with [no scopes](#441) (e.g. Calendly)
- Fetch the [list of active connections](#525) for a specific connection ID (🙏 @uncle-tee)
- New integrations: [Timely](#576) (🙏 @timm Stokke), [Smugmug](#599) (🙏 [mrcbns](https://github.com/moracabanas)) & WakaTime (🙏 @ @alan Hamlett)
- [Privacy](https://www.nango.dev/privacy-policy) & [terms](https://www.nango.dev/terms) for Nango Cloud (🙏 @robin)
- More Github Action [checks](#575) (🙏 @khaliq Gant)
- Override database [connection pool](#588) configuration (🙏 [0xRaduan](https://github.com/0xRaduan))
Bug fixes:
- [Server version](#581) was
undefined
in self-hosted logs - Frontend SDK [build issue](#612)
We are continuing to see a steady stream of amazing contributions, with a rapidly growing number of total contributors (now 75!). Thank you!!
Have a great week,
April 24, 2023
Hi everyone,
We have a LOT of improvements this week for version 0.15.0
.
The main improvement is a way to make external API request with [Nango’s proxy](https://docs.nango.dev/reference/proxy)! It automatically handles authentication for you and will soon provide lots of other goodies (retries, monitoring, etc.).
Thanks you to @anand Chowdhary, @tony Xiao, @uncle-tee, @HarrisonJackson for your precious feedback, and most of all to @khaliq Gant for the implementation!
Another contributor has been killing it this week. [Chakravarthyyy](https://github.com/Chakravarthy7102) has made no less than 12 PRs this week, including many of super cool frontend improvements listed below. Thank you for jumping in like this!
Other improvements this week:
- New integrations: [Docusign](https://docs.nango.dev/providers/docusign), [Boldsign](https://docs.nango.dev/providers/boldsign), [BambooHR](https://docs.nango.dev/providers/bamboohr), [Todoist](https://docs.nango.dev/providers/todoist) (🙏 @uncle-tee, @chandra , [dax](https://github.com/dax))
- [Hide sensitive information](#563) in the web app (🙏 [Chakravarthyyy](https://github.com/Chakravarthy7102))
- [Default scopes](#534) (🙏 @uncle-tee)
- [Better UI](#556) for filling in scopes (🙏 [Chakravarthyyy](https://github.com/Chakravarthy7102))
- Make SDK compatible with [server-side rendering](#565) (🙏 [Chakravarthyyy](https://github.com/Chakravarthy7102))
- Experimental [support](#561) for other databases than Postgres (🙏 @desen Meng)
- [Other](cd111b5) [smaller](#557) [improvements](#550) [here](fe37935)
This was an amazing week, mostly thanks to the feedback and help of the community members here. We can’t thank you enough for this.
Have a great week,
April 17, 2023
Hi everyone,
Today we are release version 0.14.0
, bringing the count to 96 integrations (hopefully 100+ next week 😎). These new integrations are:
- [Accelo](https://docs.nango.dev/providers/accelo)
- [Battlenet](https://docs.nango.dev/providers/battlenet)
- [Deel](https://docs.nango.dev/providers/deel)
- [Health Gorilla](https://docs.nango.dev/providers/healthgorilla)
- [Keap](https://docs.nango.dev/providers/keap)
- [Outreach](https://docs.nango.dev/providers/outreach)
- [Pandadoc](https://docs.nango.dev/providers/pandadoc)
- [Squareup](https://docs.nango.dev/providers/squareup)
- [Teamwork](https://docs.nango.dev/providers/teamwork)
- [Uber](https://docs.nango.dev/providers/uber)
- [Zoho Desk](https://docs.nango.dev/providers/zoho-desk)
In addition, we improved Nango’s reliability by adding [persistence storage for OAuth sessions](#426) (thank you @uncle-tee!)
Finally, we improved the onboarding by creating a default Github integration upon signing up to let you test an OAuth flow faster!
A huge shoutout for @uncle-tee who has been shipping integrations like crazy, as well as
Have a great week :)
April 11, 2023
Hi everyone,
Today we are releasing the version 0.13.4
and bring to total integration count to 88 with the following integrations:
- [Adobe](https://docs.nango.dev/providers/adobe) ([PR](#463))
- [Amazon](https://docs.nango.dev/providers/amazon) ([PR](#496))
- [Figma / Figjam](https://docs.nango.dev/providers/figma) ([PR](#440))
- [Gorgias](https://docs.nango.dev/providers/gorgias) ([PR](#483))
- [Gusto](https://docs.nango.dev/providers/gusto) ([PR](#473))
- [Mural](https://docs.nango.dev/providers/mural) ([PR](#464))
- [Miro](https://docs.nango.dev/providers/miro) ([PR](#457))
- [OneDrive](https://docs.nango.dev/providers/one-drive) ([PR](#498))
- [Payfit](https://docs.nango.dev/providers/payfit) ([PR](#485))
- [Typeform](https://docs.nango.dev/providers/typeform) ([PR](#484))
- [Zenefits](https://docs.nango.dev/providers/zenefits) ([PR](#472))
We will continue to steadily increase the number of supported integrations. And don’t hesitate to request any specific one.
Have a great week!
April 3rd, 2023
Hi all!
We are excited to release 0.13.0
today with a bunch of new integrations:
- [Atlassian](https://docs.nango.dev/providers/atlassian) ([PR](#432))
- [Factorial](https://docs.nango.dev/providers/factorial) ([PR](#387))
- [[Mailchim...