Quickstart

Integrate Prism Auth in 3 steps

Get authenticated browser sessions for any website without maintaining login scripts.

Step 1: Get Your API Key

Generate API key from dashboard

Secure your API key

Step 2: Make Your First Authentication Call

Authenticate a user with login endpoint

Use the /login endpoint to authenticate a user and receive live session cookies:

const response = await fetch("https://prismai.sh/api/login", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${process.env.PRISM_AUTH_API_KEY}`
  },
  body: JSON.stringify({
    cred: {
      username: "user@example.com",
      password: "userPassword123"
    },
    login_method: "password",
    domain: "https://github.com/login"
  })
});

const authData = await response.json();

Replace the credentials with actual user credentials for the target website.

Use the returned session cookies

Apply the returned cookies to your browser context for authenticated access:

// The API returns structured cookie data
const { cookies, origins } = authData;

// Apply cookies to your browser session
cookies.forEach(cookie => {
  // Set cookie in browser context
  // (implementation depends on your browser automation tool)
  browser.setCookie(cookie);
});

// Now make authenticated requests to the target website
const authenticatedPage = await browser.newPage();
await authenticatedPage.goto("https://github.com/dashboard");

Step 3: Implement Session Management

Handle session refresh and persistence

Store credential references for future session refresh:

// For signup endpoint, store the credential ID for refreshing
const signupResponse = await fetch("https://prismai.sh/api/signup", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${process.env.PRISM_AUTH_API_KEY}`
  },
  body: JSON.stringify({
    signup_method: "email",
    domain: "https://newservice.com/signup",
    cred: {
      email: "agent@yourcompany.com",
      password: "generated_secure_password"
    }
  })
});

const { cookies, credentialId } = await signupResponse.json();

// Store credentialId for future refresh calls
// When session expires, refresh it:
const refreshResponse = await fetch("https://prismai.sh/api/refresh", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${process.env.PRISM_AUTH_API_KEY}`
  },
  body: JSON.stringify({
    credentialId: credentialId
  })
});

Next steps

Now that you have authentication working, explore these advanced features:

Signup API

Automatically create accounts with email verification handling.

OAuth Integration

Authenticate users with Google, GitHub, and other OAuth providers.

Session Refresh

Maintain long-lived sessions without re-authentication.

API Reference

Complete API documentation with all authentication methods.

Need help? Check our API Reference for detailed endpoint documentation and authentication method examples.

Getting Started

Authentication Endpoints

Integrate Prism Auth in 3 steps

Step 1: Get Your API Key

Step 2: Make Your First Authentication Call

Step 3: Implement Session Management

Next steps

Signup API

OAuth Integration

Session Refresh

API Reference

Getting Started

Authentication Endpoints

​Integrate Prism Auth in 3 steps

​Step 1: Get Your API Key

​Step 2: Make Your First Authentication Call

​Step 3: Implement Session Management

​Next steps

Signup API

OAuth Integration

Session Refresh

API Reference

Integrate Prism Auth in 3 steps

Step 1: Get Your API Key

Step 2: Make Your First Authentication Call

Step 3: Implement Session Management

Next steps