Config IDs

Overview

A Config ID is the credential that connects your application to Hawcx. It's scoped to a specific project and environment, and it's what you pass to the Hawcx SDK to initialize authentication.

Generate a Config ID

1. Open your project and go to Settings > Config IDs
2. Ensure the correct environment is selected (Development or Production)
3. Click Generate Config ID
4. Give it a descriptive name (e.g., "iOS Test App")
5. Select the Platform — Web, iOS, or Android
6. Click Generate

The full Config ID is displayed once upon creation. Development Config IDs remain visible in the list afterward.

Development vs Production

Production Config ID Workflow

1. A developer requests a production Config ID from the project settings
2. A Hawcx admin reviews the request
3. If approved, the Config ID is generated and provisioned
4. If rejected, the developer sees the rejection reason

Revoke a Config ID

Revoking is permanent and immediately blocks all requests made with that Config ID.

1. Find the Config ID in the list
2. Click Revoke
3. Confirm the action

Admins can revoke any Config ID in the organization. Developers can only revoke Config IDs they created.

Using Your Config ID

Pass the Config ID when initializing the Hawcx SDK:

// React
<HawcxProvider config={{ configId: 'your_config_id' }}>

// Vanilla JS
const client = createHawcxAuth({ configId: 'your_config_id' });

# Environment variable
VITE_HAWCX_CONFIG_ID=your_config_id

Next Steps

• 5-Minute Integration — build a complete login flow
• Web SDK Quickstart — full frontend setup