The Firstbase integration is read-only. June can query order status, returns, and inventory but cannot create or modify records in Firstbase.
What you’ll accomplish
- Generate an API key in Firstbase
- Configure the June integration
- Understand available data and actions
- Track equipment orders and returns
Prerequisites
Before starting the integration, ensure you have:- Firstbase admin access to generate an API key
- June organization admin permissions
How June Works with Firstbase
Available Actions
June can perform the following read-only actions with Firstbase:| Action | Description |
|---|---|
| Get order | Retrieve order details including status, items, SKU info, and shipment tracking |
| List orders | List all orders with filters for date range, person, and active status |
| Get orders by person | Get all orders for a specific employee |
| Get return | Retrieve return details including status, retrieval method, and items |
| List returns | List all returns with filters for date range, person, and replacement status |
| Get returns by person | Get all returns for a specific employee |
| Get employee | Retrieve employee details from Firstbase (name, email, address, package) |
| Search employees | Search for employees by email, first name, or last name |
| Get inventory by serial | Look up inventory items by serial number |
Example Use Cases
Track equipment orders
Track equipment orders
Ask June: “What’s the status of John’s laptop order?” or “Show me all orders from the last week.”
Check pending returns
Check pending returns
Ask June: “Show me all active equipment returns” or “Which returns are still in transit?”
Find equipment by serial
Find equipment by serial
Ask June: “Who has the MacBook with serial C02XG1234?” to quickly identify equipment ownership.
Audit employee equipment
Audit employee equipment
Ask June: “What orders and returns exist for [email protected]?” for a complete equipment history.
Monitor at-risk orders
Monitor at-risk orders
Ask June: “Show me orders with delivery exceptions” to identify orders that need attention.
Setup Process
Step 1: Generate an API Key
1
Access Firstbase Settings
- Log in to Firstbase
- Navigate to Settings → API (or Integrations)
2
Create API Key
- Click Generate API Key
- Enter a descriptive name:
june-integration - Click Create to generate the key
3
Copy and Save Key
- Immediately copy the API key
- Store it securely for the next step
Step 2: Connect in June
1
Access June Integrations
- Log into June
- Navigate to Settings → Integrations
- Select Firstbase from the available integrations
2
Enter API Key
- Paste the API key from Step 1
- Click Connect
- Verify the connection status shows as Active
3
Test the Connection
- Click Test Connection to verify the setup
- June will attempt to retrieve sample data from Firstbase
- Resolve any authentication issues before proceeding
Try asking June “Show me recent Firstbase orders” to verify the integration is working.
Troubleshooting
Common Issues
Authentication failed - invalid or expired API key
Authentication failed - invalid or expired API key
Symptoms: Connection fails or shows authentication errorsSolutions:
- The API key may have been revoked in Firstbase
- Generate a new API key in Firstbase settings
- Update the API key in June’s integration settings
- Verify there are no extra spaces when pasting the key
Order not found or Employee not found
Order not found or Employee not found
Symptoms: June returns “not found” errors for specific recordsSolutions:
- Verify the ID is correct (UUIDs are case-sensitive)
- The record may have been deleted in Firstbase
- Check if you’re using the correct identifier format
Empty results when listing orders/returns
Empty results when listing orders/returns
Symptoms: Queries return no results when you expect dataSolutions:
- Check your date filters—defaults to the last 30 days
- Verify the
person_idif filtering by employee - Confirm the employee has orders/returns in Firstbase
- Try broadening your search criteria
Connection timeout errors
Connection timeout errors
Symptoms: Requests take too long and failSolutions:
- Firstbase API may be experiencing issues
- Try again in a few minutes
- Check Firstbase status page for outages
- Contact June support if the issue persists
Security Best Practices
API Key Management
- Dedicated Keys: Use a dedicated API key for June so it can be revoked independently if needed
- Secure Storage: API keys are encrypted at rest in June’s secure storage
- Regular Rotation: Consider rotating API keys periodically (quarterly recommended)
- Access Auditing: Review API access logs in Firstbase regularly
Data Access
- Read-Only Access: The Firstbase integration cannot create or modify orders—only read data
- Minimal Scope: June only accesses the data needed for equipment tracking
Next Steps
Once your Firstbase integration is configured:MDM Integration
Connect device management to correlate Firstbase orders with managed devices
Identity Providers
Sync employee data to match Firstbase records with June users
Asset Discovery
View Firstbase equipment alongside your complete asset inventory
AI Insights
Use AI to analyze equipment trends and procurement patterns
Support Resources
Need help with your Firstbase integration?- Firstbase Documentation: Review Firstbase’s API documentation for additional details
- June Support: Contact support for integration-specific assistance
The Firstbase integration establishes connection within minutes. Equipment data is available immediately after successful authentication.