API

Feedback Needed for New API Feature: App Notebooks

Posted by Brett Kelly on 08 May 2014

Posted by Brett Kelly on 08 May 2014

Comment

app-notebooks-614

We’re pleased to announce the beta release for our most-requested API feature: Single Notebook Authorization — We’re calling this feature “App Notebooks”. Beginning this summer, third-party developers can connect their application exclusively to a single notebook within a given user’s Evernote account.

Read the new documentation here: App Notebooks API docs

This benefits both our users and developers:

  • Users can choose the scope for which notebook an app can read
  • Developers choose whether their application fits in this model
  • User data is kept secure for business and personal notebooks
  • Server-side optimizations allow for faster API access

How does App Notebook work?

When a user is prompted to authorize an application to access his/her Evernote account, the user will have a few options:

  • Create a new notebook for the application to use; this is the default behavior; the notebook will have the same name as the application
  • Create a new notebook with a custom name
  • Select an existing notebook from their account to be used by the application

The good news is, App Notebooks will require very little in terms of code modifications — most of the magic happens on the server during the OAuth process.

We need your help!

This feature is about to enter private beta testing and we’re looking for a small group of partners to help us work out the kinks. If you’re interested, please let us know by filling out this form. All partners chosen for the beta will receive a complimentary year of Evernote Premium.

FAQs

“What if my app needs access to a user’s entire Evernote account to function properly?”

During the API creation process, you’ll have the opportunity to request full account access for your API key.

“What about existing API keys?”

All existing API keys will retain their current permission level.

If you have any questions, please post them in the comments below or in our developer forum and we’ll answer them as quickly as possible. Also, documentation for this feature will be provided to testers during the beta period and published to the Evernote Developer site when App Notebooks go live this summer.

Example Flow

auth-app

change-notebook

 

notebook-chooser

View more stories in 'API'