Documentation / Authentication

Authentication

Learn how to authenticate with the WebinOne API using OAuth 2.0

The WebinOne Admin API uses OAuth 2.0 for authentication. You'll need to obtain an access token before making API requests.

Obtaining API Credentials

First, you need to create an API application in your WebinOne admin panel:

  1. Log in to your WebinOne admin panel
  2. Navigate to Settings → API Applications
  3. Click Create New Application
  4. Enter a name for your application
  5. Copy your Client ID and Client Secret

OAuth 2.0 Token Request

To obtain an access token, make a POST request to the OAuth endpoint:

Endpoint: /api/v1/oauth/token (Note: OAuth is v1, not v2)

Content-Type: multipart/form-data

Required Parameters

  • grant_type - Must be client_credentials
  • client_id - Your application's client ID
  • client_secret - Your application's client secret
  • scope - Must be public_api

Using the Access Token

Once you have an access token, include it in the Authorization header of your requests:

Authorization: Bearer YOUR_ACCESS_TOKEN

Access tokens expire after 3600 seconds (1 hour). You'll need to request a new token when the current one expires.

Code Examples

# cURL Example
curl -X POST https://your-site.webinone.com/api/v1/oauth/token \
  -H "Content-Type: multipart/form-data" \
  -F "grant_type=client_credentials" \
  -F "client_id=YOUR_CLIENT_ID" \
  -F "client_secret=YOUR_CLIENT_SECRET" \
  -F "scope=public_api"

# Response
{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 3600
}