Receiving Credentials

Understand the credentials you receive after tenant registration

Receiving Credentials

After completing the registration process, you will receive your FinHub credentials to access the platform.

Credentials Package

You will receive the following credentials:

API Credentials

Credential	Description	Usage
Tenant ID	Unique identifier for your organization	Required in X-Tenant-ID header
Client ID	API client identifier	Used for authentication
Client Secret	API client secret	Used for authentication
Sandbox URL	Base URL for sandbox API	API endpoint

Portal Access

Access	Description
Tenant Operation Panel	Administrative dashboard for managing your tenant
Developer Portal	Access to API documentation and playground

Credential Delivery

Credentials are delivered securely via:

1. Welcome Email - Contains portal access and initial setup instructions
2. Developer Portal - API credentials available after first login
3. Secure Channel - Client secrets delivered via secure channel

Security Best Practices

Never share your credentials or commit them to version control systems.

• Store credentials securely using environment variables or secret management
• Rotate credentials periodically
• Use different credentials for sandbox and production
• Implement proper access control for credential access

Verifying Your Credentials

Test your credentials with a simple authentication request:

curl -X POST "https://gateway.sandbox.finhub.cloud/api/v2/auth/sandbox/token" \
  -H "Content-Type: application/json" \
  -H "X-Tenant-ID: YOUR_TENANT_ID" \
  -d '{
    "username": "YOUR_USERNAME",
    "password": "YOUR_PASSWORD",
    "customerId": "YOUR_CLIENT_ID",
    "customerSecret": "YOUR_CLIENT_SECRET",
    "accountType": "b2b"
  }'

A successful response indicates your credentials are working correctly.

Next Steps

Development Environment

Set up your sandbox

Categorization Hierarchy

Understand customer categories