Documentation Index
Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
Use this file to discover all available pages before exploring further.
🚀 Quickstart
🧑💻 OAuth app setup
🔗 Useful links
🚨 API gotchas
Create an integration
In Nango (free signup), go to Integrations -> Configure New Integration -> Ironclad. Nango doesn’t provide a test OAuth app for Ironclad yet. You’ll need to set up your own by following these instructions. After that, make sure to add the OAuth client ID, secret, and scopes in the integration settings in Nango. Authorize Ironclad
Go to Connections -> Add Test Connection -> Authorize, then log in to Ironclad. Later, you’ll let your users do the same directly from your app. Call the Ironclad API
Let’s make your first request to the Ironclad API (fetch a list of all workflows). Replace the placeholders below with your secret key, integration ID, and connection ID:curl "https://api.nango.dev/proxy/public/api/v1/workflows?pageSize=10" \
-H "Authorization: Bearer <NANGO-SECRET-KEY>" \
-H "Provider-Config-Key: <INTEGRATION-ID>" \
-H "Connection-Id: <CONNECTION-ID>"
Install Nango’s backend SDK with npm i @nangohq/node. Then run:import { Nango } from '@nangohq/node';
const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });
const res = await nango.get({
endpoint: '/public/api/v1/workflows',
params: {
pageSize: 10
},
providerConfigKey: '<INTEGRATION-ID>',
connectionId: '<CONNECTION-ID>'
});
console.log(JSON.stringify(res.data, null, 2));
The Ironclad API uses different base URLs depending on your environment. Nango automatically handles the correct base URL based on your environment configuration.
Create an Ironclad account
If you don’t already have one, request a demo to sign up for an Ironclad account. Access Ironclad Company Settings
Navigate to your Ironclad instance and click on your user profile dropdown at the top right-hand corner, then select Company Settings.
Navigate to API Settings
- Select the API tab on the left sidebar.
The API tab will only be visible if you have the API add-on enabled for your instance.
Create a new OAuth application
- Click on the Create new app button.
- A popup will appear - enter the required information and click “Create app”.
- After creating the app, the Client ID and Client Secret will be generated. Save these as you will need them when configuring your integration in Nango.
Configure OAuth application details
- After closing the modal, fill out all the necessary information, for:
- Grant Types: Select Authorization Code.
- Redirect URIs: Enter
https://api.nango.dev/oauth/callback as the allowed redirect URI.
- Click Save Changes.
Next
Follow the Quickstart to complete your integration setup.
- Ironclad operates across multiple environments, each with its own base URL:
- Production (NA):
https://na1.ironcladapp.com
- Production (EU):
https://eu1.ironcladapp.com
- Demo:
https://demo.ironcladapp.com
- Every Ironclad API endpoint requires specific resource scopes (e.g.,
public.workflows.createdWorkflows). Check the API documentation for each endpoint to identify the necessary scopes.
- Each Ironclad environment operates independently. OAuth applications created on one environment cannot be used on other environments and must be recreated separately for each environment you need to access.
