Namely

Overview

Pre-built tooling

Pre-built integrations

Access requirements

Setup guide

Useful links

API gotchas

Pre-built tooling

✅ Authorization

Tools	Status
Pre-built authorization (OAuth)	✅
Credentials auto-refresh	✅
Auth parameters validation	✅
Pre-built authorization UI	✅
Custom authorization UI	✅
End-user authorization guide	✅
Expired credentials detection	✅

✅ Read & write data

Tools	Status
Pre-built integrations	🚫 (time to contribute: <48h)
API unification	✅
2-way sync	✅
Webhooks from Nango on data modifications	✅
Real-time webhooks from 3rd-party API	🚫 (time to contribute: <48h)
Proxy requests	✅

✅ Observability & data quality

Tools	Status
HTTP request logging	✅
End-to-end type safety	✅
Data runtime validation	✅
OpenTelemetry export	✅
Slack alerts on errors	✅
Integration status API	✅

✅ Customization

Tools	Status
Create or customize use-cases	✅
Pre-configured pagination	🚫 (time to contribute: <48h)
Pre-configured rate-limit handling	🚫 (time to contribute: <48h)
Per-customer configurations	✅

No pre-built syncs or actions available yet.

Not seeing the integration you need? Build your own independently.

Access requirements

Pre-Requisites	Status	Comment
Paid dev account	✅ Required	You must have an active Namely account with API access. Self-service signup is not available. Contact Namely if you need access.
Paid test account	✅ Required	You must use a real Namely account for testing. There is no free test account option.
Partnership	✅ Not required
App review	✅ Not required
Security audit	✅ Not required

Setup guide

1. Access the Namely API section

   Log in to your Namely site.
   Click the Admin dropdown and select API. If you don’t see the API menu, contact your Namely administrator or client success manager to obtain the necessary permissions.

2. Create an OAuth application

   In the API section, navigate to the OAuth Applications tab.
   Click to create a new OAuth application and fill out the following fields:

   • Name: Enter a human-readable name for your OAuth app (e.g. Nango Integration).
   • Website: Enter your company’s website (e.g. https://example.com).
   • Redirect URI(s): Specify one or more redirect URIs. Use a comma-separated list if you have multiple.

   For Nango, configure the following Redirect URL: https://api.nango.dev/oauth/callback.

   After creating the app, copy/paste the Client ID and Client Secret; you will need them when configuring Nango.

3. Next

   Follow the Quickstart to set up your Namely integration in Nango.

Need help getting started? Get help in the community.

Contribute improvements to the setup guide by editing this page

Useful links

Topic	Links
General	Website
Developer	API documentation
	Authorization documentation
	How to register an OAuth app
	Details on rate limits

Contribute useful links by editing this page

API gotchas

• Namely’s API limits GET /profiles to 100 requests per minute, returning HTTP 406 if exceeded.

Contribute API gotchas by editing this page

Going further

Connect to Namely

Guide to connect to Namely using Connect UI