Overview
The Accessly API uses a standard OAuth 2.0 / OpenID Connect inspired flow. This allows your users to sign in to your webservice using their Accessly credentials without sharing their password with you.
Key Benefit: Reduce friction at signup. Users with an Accessly ID can log in with one click.
1 Register your Application
Before you can start, you need to register your app in the Developer Portal to obtain your CLIENT_ID and CLIENT_SECRET.
You will also need to whitelist your Redirect URI (e.g., https://yourapp.com/callback).
2 Initiate Authentication
Redirect the user to our authorization server. This will present the user with the Accessly login screen (if they aren't already logged in).
GET https://accessly.it/oauth/authorize?
response_type=code
&client_id=YOUR_CLIENT_ID
&redirect_uri=https://yourapp.com/callback
&scope=profile email
3 Exchange Code for Token
If the user approves access, we will redirect them back to your redirect_uri with a temporary code. Exchange this code for an access token directly from your server.
POST https://accessly.it/oauth/token
Content-Type: application/json
{
"grant_type": "authorization_code",
"code": "received_auth_code",
"redirect_uri": "https://yourapp.com/callback",
"client_id": "YOUR_CLIENT_ID",
"client_secret": "YOUR_CLIENT_SECRET"
}
Response:
{
"access_token": "ac89...421",
"token_type": "Bearer",
"expires_in": 3600
}
4 Fetch User Profile
Now you can use the access_token to identify the user.
GET https://accessly.it/api/v1/userinfo
Authorization: Bearer ac89...421
Response:
{
"sub": "user_123456",
"name": "Mario Rossi",
"email": "mario.rossi@example.com",
"verified": true
}
Ready to start?
Join the Partner Program today.
Get API Keys