Skip to main content

​
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

CredentialDescriptionUsage
Tenant IDUnique identifier for your organizationRequired in X-Tenant-ID header
Client IDAPI client identifierUsed for authentication
Client SecretAPI client secretUsed for authentication
Sandbox URLBase URL for sandbox APIAPI endpoint

​
Portal Access

AccessDescription
Tenant Operation PanelAdministrative dashboard for managing your tenant
Developer PortalAccess 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