Obtain access token
External applications could obtain a user authorized API token via the OAuth2 protocol. Before getting started, developers need to create their applications in App Management Console and configure a valid OAuth redirect URL. A registered Raindrop.io application is assigned a unique
Client ID
and Client Secret
which are needed for the OAuth2 flow.This procedure is comprised of several steps, which will be described below.
If you just want to test your application, or do not plan to access any data except yours account you don't need to make all of those steps.
Just go to App Management Console and open your application settings. Copy Test token and use it as described in Make authorized calls.
get
https://raindrop.io
/oauth/authorize
Step 1: The authorization request

User will be asked if he would like to grant your application access to his Raindrop.io data
Here example CURL request:
curl "https://api.raindrop.io/v1/oauth/authorize?client_id=5e1c382cf6f48c0211359083&redirect_uri=https:%2F%2Foauthdebugger.com%2Fdebug"
When the user grants your authorization request, the user will be redirected to the redirect URL configured in your application setting. The redirect request will come with query parameter attached:
code
.The
code
parameter contains the authorization code that you will use to exchange for an access token.In case of error redirect request will come with
error
query parameter:Error | Description |
access_denied | When the user denies your authorization request |
invalid_application_status | When your application exceeds the maximum token limit or when your application is being suspended due to abuse |
post
https://raindrop.io
/oauth/access_token
Step 3: The token exchange
Here an example CURL request:
curl -X "POST" "https://raindrop.io/oauth/access_token" \
-H 'Content-Type: application/json' \
-d $'{
"code": "c8983220-1cca-4626-a19d-801a6aae003c",
"client_id": "5e1c589cf6f48c0211311383",
"redirect_uri": "https://oauthdebugger.com/debug",
"client_secret": "c3363988-9d27-4bc6-a0ae-d126ce78dc09",
"grant_type": "authorization_code"
}'
post
https://raindrop.io
/oauth/access_token
♻️ The access token refresh
Last modified 2yr ago