Route Import & Export
Export your webhook routes as JSON and import them into other organizations or environments. Perfect for staging-to-production workflows.
Overview
Managing webhook configurations across multiple environments can be challenging. With Route Import & Export, you can:
- Export your entire route configuration as JSON
- Import routes into other organizations
- Version control your webhook infrastructure
- Quickly set up new environments
Exporting Routes
Navigate to Settings > Import/Export in your dashboard, or use the API:
bash
curl https://api.hookbase.app/api/organizations/{orgId}/routes/export \
-H "Authorization: Bearer YOUR_TOKEN" \
-o routes.jsonThe export includes:
- Sources with their configurations
- Destinations and authentication settings
- Routes with filters and transforms
- Schemas for validation
Importing Routes
Upload your JSON file or use the API:
bash
curl -X POST https://api.hookbase.app/api/organizations/{orgId}/routes/import \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d @routes.jsonImport Options
| Option | Description |
|---|---|
overwrite | Replace existing routes with the same name |
skip | Skip routes that already exist |
merge | Merge new destinations into existing routes |
Use Cases
Staging to Production
- Build and test routes in staging
- Export the configuration
- Import into production
- Update destination URLs as needed
Disaster Recovery
Keep versioned exports of your route configurations in git. Restore quickly if needed.
Team Collaboration
Share route configurations with team members or across organizations.