Skip to content

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.json

The 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.json

Import Options

OptionDescription
overwriteReplace existing routes with the same name
skipSkip routes that already exist
mergeMerge new destinations into existing routes

Use Cases

Staging to Production

  1. Build and test routes in staging
  2. Export the configuration
  3. Import into production
  4. 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.

Learn More

Released under the MIT License.