Switch Between Different Nash Organizations

Last updated: February 7, 2025

If you are part of multiple Nash Organizations, you can seamlessly switch between them to manage deliveries, settings, and configurations specific to each. This functionality is especially useful for overseeing logistics across various locations under a single corporate structure.

Switching Organizations

  1. Locate the Organization Selector:

    • In the Nash portal, find the Switch Org link in the top left corner of the interface.

  2. Choose the Desired Organization:

    • Click on the current organization name.

    • Select the organization you want to access from the list.

    • Click Continue to confirm.

  3. Refresh Portal:

    • The portal will refresh, providing access to the selected organization's data and settings.

Using the Nash API for Multiple Organizations

When using the Nash API and accessing multiple organizations, it’s crucial to specify the correct organization for each request.

Steps for API Requests:

  1. Ensure API Key Access:

    • Verify that your API key has access to the organization you wish to interact with.

  2. Specify the Organization in the Header:

    • Include the Nash-Org-Id header in your API requests.

    • Set its value to the Organization ID of the desired organization.

Example API Request:

bash

curl --request GET \ --url https://api.sandbox.usenash.com/v1/jobs \ --header 'Authorization: Bearer <YOUR_API_KEY>' \ --header 'Nash-Org-Id: org_AbC123'

  • Replace org_AbC123 with the actual Organization ID you wish to access.

  • API responses will include a job_id in the X-Job-Id header for tracking purposes.

Best Practices

  • Verify Active Organization: Always check which organization you're working in before making any changes or viewing data.

  • Double-Check API Headers: Ensure the Nash-Org-Id header accurately reflects the intended organization in API requests.

  • Understand Organization Settings: If you're an administrator for multiple organizations, familiarize yourself with their specific settings, configurations, and access permissions.

  • Display Sorting: Organizations in the selector are sorted alphabetically using locale-aware sorting for accurate display.

  • Display Limits: Up to 100 organizations can be displayed in the organization selector.

By following these steps and best practices, you can efficiently manage operations across multiple Nash Organizations while avoiding errors.