Authentication Auth2.0 - Authorization code

Add extra fields only if needed.

👉 Example:

• Environment (sandbox / production)

• Region

💡 Keep it minimal — users shouldn’t fill unnecessary inputs

This is where users return after login.

👉 Copy from viaSocket
👉 Paste into your app’s developer settings

⚠️ Must match exactly or login will fail

Enter:

• Client ID → identifies your app

• Client Secret → private key (keep it secure)

👉 Get these from the app you are connecting

This is the login page of the app.

👉 Example:

https://service.com/oauth/authorize

• User clicks Connect

• Gets redirected to login

• After login, returns to viaSocket

• A temporary code is sent

This completes the connection.

👉 viaSocket sends the code
👉 App returns an access token

👉 This token is used to access user data

Used when the access token expires

👉 Keeps the connection active
👉 User doesn’t need to log in again

Used to disconnect users

👉 Stops further API access

Add a test endpoint to verify the connection.

👉 Example:/me or /profile

• This is used to check if credentials are valid

💡 Choose a simple endpoint that always returns data

Define how the connection will appear to users.

👉 Example: John’s Account

👉 Use dynamic values like name or email if available

Add the API base URLs your integration will use.

• Only include required domains

• Avoid unnecessary URLs

✔ Helps keep your connection secure

💡 Prevents unwanted or unsafe calls

Used to identify each user connection

👉 Example:

• email

• account_id

👉 Helps avoid duplicate connections

Use this to automatically include values in every API request.

What does this do?

It allows you to define default key-value pairs that are added to every request.

You can configure:

• Headers

• Query Parameters

• Body

👉 These values are automatically applied to all requests made through this connection.

Authorization: Bearer {{access_token}}

api_key: {{api_key}}

version: v2

• Same headers are required in every request

• You want to avoid repeating authentication logic

• Your API needs fixed parameters

• Values change per request

• Different endpoints need different values

⚠️ Don’t add sensitive data here

👉 Click Connect to [App]