Learn how to get started with Cellular, Wi-Fi, LoRa, and Satellite using Blues Notecard on September 25th

Blues Developers
What’s New
Resources
Blog
Technical articles for developers
Newsletter
The monthly Blues developer newsletter
Terminal
Connect to a Notecard in your browser
Developer Certification
Get certified on wireless connectivity with Blues
Webinars
Listing of Blues technical webinars
Blues.comNotehub.io
Shop
Docs
Button IconHelp
Notehub StatusVisit our Forum
Button IconSign In
Docs Home
What’s New
Resources
Blog
Technical articles for developers
Newsletter
The monthly Blues developer newsletter
Terminal
Connect to a Notecard in your browser
Developer Certification
Get certified on wireless connectivity with Blues
Webinars
Listing of Blues technical webinars
Blues.comNotehub.io
Shop
Docs
API Reference
Glossary
System Notefiles
Notecard API
Introduction
card Requests
dfu Requests
env Requests
file Requests
hub Requests
note Requests
ntn Requests
var Requests
web Requests
Notehub API
API Introduction
Authorization API
Generate OAuth Token
Billing Account API
Device API
Event API
Monitor API
Project API
Route API
homechevron_rightDocschevron_rightAPI Referencechevron_rightNotehub APIchevron_rightAuthorization API - Notehub API Reference

Authorization API

The Notehub authorization API contains endpoints to generate authentication tokens for use with other Notehub API requests.

NameHTTP Request
Generate OAuth TokenPOST /oauth2/token

Generate OAuth Token Notehub

Generate an OAuth bearer token that can be used to authenticate subsequent Notehub API requests.

HTTP Method:POST
URL:https://api.notefile.net/oauth2/token
Arguments

grant_type

string

This argument must be set to "client_credentials".

client_id

string

The Client ID from the Programmatic API access section of a Notehub project. See here for details.

client_secret

string

The Client secret from the Programmatic API access section of a Notehub project. See here for details.

curl -X POST
 -L 'https://notehub.io/oauth2/token'
 -H 'content-type: application/x-www-form-urlencoded'
 -d grant_type=client_credentials
 -d client_id=your-client-id
 -d client_secret=your-client-secret
Response Members

access_token

string

The string OAuth bearer token. This is the value you’ll want to save for use in subsequent Notehub API requests.

expires_in

integer

The number of seconds until the access token expires.

token_type

string

The type of token returned. Currently this will always be set to "bearer".

Example Response
{
  "access_token": "abc123...",
  "expires_in": 1799,
  "token_type": "bearer"
}
API Introduction Billing Account API
Can we improve this page? Send us feedback
© 2025 Blues Inc.
© 2025 Blues Inc.
TermsPrivacy
Notecard Disconnected
Having trouble connecting?

Try changing your USB cable as some cables do not support transferring data. If that does not solve your problem, contact us at support@blues.com and we will get you set up with another tool to communicate with the Notecard.

Advanced Usage

The help command gives more info.

Connect a Notecard
Use USB to connect and start issuing requests from the browser.
Try Notecard Simulator
Experiment with the Notecard's API on a Simulator assigned to your free Notehub account.

Don't have an account? Sign up