B2B Saas Authentication

/

API reference

/

Overview

B2B SaaS Authentication API Reference

Explore the details of the Stytch B2B API. Our B2B SaaS Authentication API is organized around REST principles and has resource-oriented URLs, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

All B2B API resources are scoped to the Project of the API keys you provide.

API keys

To connect to the Stytch API, you need to authenticate your requests using your project_id and secret from the API Keys section in your Project's Dashboard.

  • For direct API calls, you'll need to pass these credentials into the Authorization request header using basic authentication.

  • For our backend SDKs, you'll need to provide these credentials when initializing the Stytch SDK client.

const stytch = require('stytch');

const client = new stytch.B2BClient({
  project_id: "PROJECT_ID",
  secret: "SECRET",
});
from stytch import B2BClient

client = B2BClient(
  project_id="PROJECT_ID",
  secret="SECRET",
)
require 'stytch'

client = StytchB2B::Client.new(
  project_id: "PROJECT_ID",
  secret: "SECRET"
)
import (
    "context"

    "github.com/stytchauth/stytch-go/v12/stytch"
    "github.com/stytchauth/stytch-go/v12/stytch/b2b/b2bstytchapi"
    "github.com/stytchauth/stytch-go/v11/stytch/b2b/organizations"
)

stytchClient, err := b2bstytchapi.NewClient(
    "PROJECT_ID",
    "SECRET",
)
import com.stytch.java.b2b.StytchB2BClient;
StytchClient.configure(
    "PROJECT_ID",
    "SECRET"
);
curl --request POST \
  --url https://test.stytch.com/v1/b2b/organizations \
  -u 'PROJECT_ID:{$secret}' \
  -H 'Content-Type: application/json' \
  -d '{
    "organization_name": "Example Org Inc.",
    "organization_slug": "example-org"
  }'

Environments

For every Stytch project, there are two environments, TEST and LIVE, and each have their own API root URLs, test.stytch.com and api.stytch.com respectively.

All resources and data objects are tied to the environment they were created in. Also, the ids include their respective environment. For example, member-test-16d9ba61-97a1-4ba4-9720-b03761dc50c6 indicates a Member was created in the TEST environment.

API keys

Environments