Onboarding

Get started with Flint in minutes. This guide walks you through initial setup and authentication.

1. Create Your Account

Sign up at app.flint.ai to get started. You'll receive:

• Organization ID
• API credentials
• Sandbox environment access

2. API Keys

Generate API Keys

Navigate to Settings → API Keys to generate your credentials:

# Your API credentials will look like:
FLINT_API_KEY=flnt_live_abc123...
FLINT_SECRET=flnt_secret_xyz789...

Key Types

• Live Keys (flnt_live_*) - For production use
• Test Keys (flnt_test_*) - For sandbox/development
• Webhook Keys (flnt_whk_*) - For webhook signature verification

3. Sandbox Environment

The sandbox environment allows you to:

• Test document parsing without charges
• Validate integrations before going live
• Access sample documents and test data

Sandbox Limitations

• Documents are retained for 7 days
• Rate limits: 100 requests/minute
• No real email connections
• Test data only for integrations

4. Authentication Basics

API Authentication

All API requests require authentication headers:

curl https://api.flint.ai/v1/documents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Flint-Secret: YOUR_SECRET"

5. Organization Setup

Configure Your Organization

1. Team Members - Invite team members with appropriate roles
2. Webhooks - Set up webhook endpoints for real-time updates
3. Integrations - Connect to Magaya, NetSuite, or other systems
4. Email Inboxes - Configure email parsing connections

Roles and Permissions

• Admin - Full access to all features and settings
• Developer - API access and webhook configuration
• Operator - Document processing and workflow management
• Viewer - Read-only access to documents and reports

Next Steps

• Terminology Guide - Understand key freight and Flint terms
• Quick Start - Process your first document
• API Authentication - Detailed authentication documentation