Request Authorization
Some APIs require authorization to ensure secure access. This usually means sending specific headers or parameters along with your request.
You can set this up in the Authorization tab. Once configured, Note API Connector will automatically include these details whenever your request is executed.
Note API Connector supports the following methods:
Most APIs provide an "Authentication" section in their documentation to tell you which method to use.
Bearer token authentication
To authorize an API request:
1️⃣ Open the Create Request screen.
2️⃣ Click the Authorization tab.
3️⃣ Click the Bearer token tab.
4️⃣ Enter your token in the Bearer token input field without 'Bearer' prefix.
Basic authentication
1️⃣ Open the Create Request screen.
2️⃣ Click the Authorization tab.
3️⃣ Click the Basic tab.
4️⃣ Enter the username in the Username input.
5️⃣ Optionally, enter the password in the Password input.
OAuth connection
Some APIs only allow access through OAuth. This is common with services like Google, Salesforce, or Zoho.
Set Up an App on the API Provider
First, you need to create an application inside your API provider's developer console. Check their documentation under the “OAuth” or “Authorization” section for specific steps.
During setup, the API provider may ask for a redirect URL. Use this one:
https://api.noteapiconnector.com/oauth/callback
Once set up, you'll receive a Client ID and Client Secret. Save them somewhere secure—you'll need them soon.
Create a Custom OAuth Connection in Note API Connector
1️⃣ Open the Create Request view.
2️⃣ Click the Authorization tab.
3️⃣ Click the OAuth tab.
4️⃣ Click the New to add new Oauth connection.
This will open the custom OAuth connection screen, where you can enter the details of your OAuth app:
- Name: Give this connection a name that helps you remember what it's for (e.g.
Google CalendarorHubSpot Connection). - Authorization Base URL: This is the link that opens a window to ask for access to your account. Example:
https://accounts.google.com/o/oauth2/auth. - Token URL: This is where the system sends your authorization code to exchange it for an access token. Example:
https://oauth2.googleapis.com/token. - Client ID: This is the public key for your app, which you received as Client ID in previous step.
- Client Secret: This is the private key for your app, which you received as Client Secret in previous step.
- Scopes: These define what kind of access you want (e.g. read-only, write access). You can usually copy them directly from the API’s OAuth documentation. Scopes should be separated by spaces.
After you've filled everything in, click Create connection. Note API Connector will open a popup window and redirect you to the API provider (like Google or Zoho) to approve the connection.
If everything is set up correctly, you’ll see a success message. Your new OAuth connection is now ready to use in any API request.
If something went wrong, you’ll see an error message instead. No worries. Just double-check your fields (especially the URLs, Client ID, and Scopes) and try again. You can also update an existing connection without creating a new one.
Examples
Our blog features step-by-step tutorials that guide you through setting up OAuth connections for a variety of popular apps and services. Some examples include:
Each tutorial includes screenshots and configuration tips tailored to the specific platform.