viaSocket Help

Authentication - Basic Auth


Set up Basic Auth to connect your app.

Screenshot 2026-03-31 at 1.37.28 PM.png
#

Before you start

Keep this ready:

  • API Key or Username & Password

  • A working API endpoint for testing


#

Setup Steps

#

Step 1 — Add required fields

Define what users need to enter:

  • API Key or

  • Username and Password

👉 Use clear names like:

  • API Key

  • Account Username

✔ Mark fields as required if needed
📘 Field setup explained in: Input Fields Guide


#

Step 2 — Configure Test API

Add a test endpoint to verify the connection.

  • Example: /me or /profile

  • This is used to check if credentials are valid

✔ Use a lightweight endpoint for faster response


#

Step 3 — Set connection label

Define how the connection will appear to users.

  • Example: John’s Account

👉 Use dynamic values like name or email if available


#

Step 4 — Add allowed URLs

Add the API base URLs your integration will use.

  • Only include required domains

  • Avoid unnecessary URLs

✔ Helps keep your connection secure


#

Step 5 — Set Request Parameters

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.

#

Common examples

#

Header authentication

Authorization: Bearer {{access_token}}
#

API key

api_key: {{api_key}}
#

Static parameter

version: v2
#

When to use this

  • Same headers are required in every request

  • You want to avoid repeating authentication logic

  • Your API needs fixed parameters

#

When NOT to use this

  • Values change per request

  • Different endpoints need different values


#

Final Step — Test your connection

👉 Click Connect to Google Sheet (right-side connection panel)

Screenshot 2026-03-31 at 2.18.19 PM.png
#

Common issues

  • Invalid API key or credentials

  • Incorrect test API endpoint

  • Missing required fields


#

FAQs

1. Why is my connection failing?
Wrong credentials or Test API.

2. What does “Connect” do?
It verifies credentials using your Test API.

3. Do I need auth in every API call?
No. Use Set Request Parameters.

4. What is “Key” in fields?
The exact parameter name your API expects.

5. Basic Auth or OAuth 2.0?
Basic → simple use
OAuth → secure/public apps

6. Can I update credentials later?
Yes.

7. Is Basic Auth secure?
Yes (with HTTPS), but weaker than OAuth.

8. Works in Postman but not here?
Check headers, params, and Test API.