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 -> Jobber. Nango doesn’t provide a test OAuth app for Jobber yet. You’ll need to set up your own by following these instructions. After that, make sure to add the OAuth client ID, and secret in the integration settings in Nango. Authorize Jobber
Go to Connections -> Add Test Connection -> Authorize, then log in to Jobber. Later, you’ll let your users do the same directly from your app. Call the Jobber API
Let’s make your first request to the Jobber API (fetch a list of users). Replace the placeholders below with your secret key, integration ID, and connection ID:curl -X POST "https://api.nango.dev/proxy/graphql" \
-H "Authorization: Bearer <NANGO-SECRET-KEY>" \
-H "Provider-Config-Key: <INTEGRATION-ID>" \
-H "Connection-Id: <CONNECTION-ID>" \
-H "Content-Type: application/json" \
-d '{"query":"{ user { id name { first last } } }"}'
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.post({
endpoint: '/graphql',
data: {"query":"{ user { id name { first last } } }"},
providerConfigKey: '<INTEGRATION-ID>',
connectionId: '<CONNECTION-ID>'
});
console.log(JSON.stringify(res.data, null, 2));
Create a Jobber developer account
Create a new App
- Navigate to Manage Apps.
- Click the + New button on the top right corner.
- Fill in all the required information. For Callback URL, add
https://api.nango.dev/oauth/callback, then save the app.
Get your credentials
- After creating the app, copy the Client ID and Client Secret that will be generated by Jobber. You’ll need these when configuring your integration in Nango.
-
The application is granted an access level permission based on the scopes defined when the app was created, so there is no need to specify scopes in Nango.
-
Jobber enforces a limit of 2,500 requests every 5 minutes on a per app/account basis rather than by IP address. If an app exceeds this limit, any subsequent requests to that Jobber account will return a 429 Too Many Requests error. For more details, see the API Rate Limiting documentation
