OAuth Setup

Set up OAuth authentication for custom integrations.

OAuth 2.0 Flow

Syntrigen supports the Authorization Code flow:

1. User initiates connection 2. Redirect to authorization URL 3. User grants permissions 4. Receive authorization code 5. Exchange for access token 6. Use token for API calls

Creating OAuth Credentials

Step 1: Register Your App

In Settings > Developer > OAuth Apps, click "New App".

Step 2: Configure Settings

- App Name: Display name for users - Redirect URIs: Allowed callback URLs - Scopes: Required permissions

Step 3: Get Credentials

Copy your: - Client ID - Client Secret (keep secure!)

Example Code

const authUrl = 'https://api.syntrigen.com/oauth/authorize';
const params = new URLSearchParams({
  client_id: 'YOUR_CLIENT_ID',
  redirect_uri: 'https://yourapp.com/callback',
  response_type: 'code',
  scope: 'read write'
});
window.location = ${authUrl}?${params};

Token Management

- Access tokens expire in 1 hour - Refresh tokens expire in 30 days - Store tokens securely - Implement token refresh logic