Help Center
Back to App Freight Wranglers Freight Wranglers Help

Admin

The Admin section provides system configuration, integration management, and operational logs for administrators.

Integration Dashboard

View and manage all third-party integrations from a central dashboard.

How to use it

  1. Navigate to Admin → Integration Dashboard
  2. View the status of each configured integration
  3. Enable or disable integrations
  4. Configure API keys and connection settings
  5. Test connections to verify they're working

Available integrations

  • ELD — Samsara, Motive (KeepTruckin)
  • Accounting — QuickBooks
  • Mileage — Trimble/PC*MILER
  • Compliance — FMCSA API
  • Load Boards — DAT, Truckstop
  • Fuel Cards — EFS, Comdata
  • Weather — Weather service API

Webhooks

Configure outgoing webhook endpoints that receive real-time event notifications from the TMS. Use webhooks to trigger automations in tools like n8n, Zapier, or Make when events happen in your TMS.

How to use it

  1. Navigate to Admin → Webhooks
  2. Click + Add Subscription to create a new endpoint
  3. Enter the destination URL (HTTPS recommended) and optional HMAC signing secret
  4. Select which event types to subscribe to using the category checkboxes
  5. Use the Test button to send a test payload to verify connectivity
  6. Monitor delivery status — failed deliveries are retried up to 5 times with exponential backoff

Webhook delivery details

  • Payloads are delivered as POST requests with Content-Type: application/json
  • Each request includes an X-Webhook-Event header with the event type
  • If an HMAC secret is configured, an X-Webhook-Signature header is included (sha256=<hex>)
  • Failed deliveries retry with exponential backoff: ~1 min, ~5 min, ~25 min, ~2 hr, ~10 hr

Available webhook events

Load Events

  • load.created — New load created
  • load.updated — Load details modified
  • load.deleted — Load deleted
  • load.status_changed — Load status advanced (includes previous and new status)
  • load.dispatched — Load dispatched to a driver with equipment
  • load.reassigned — Load reassigned to a different driver
  • load.carrier_assigned — Load assigned to a carrier company

Invoice Events

  • invoice.created — New invoice created
  • invoice.updated — Invoice details modified
  • invoice.deleted — Invoice deleted
  • invoice.generated — Invoice auto-generated from a delivered load
  • invoice.sent — Invoice sent to customer
  • invoice.voided — Invoice voided
  • invoice.payment_recorded — Payment recorded against invoice

Driver Events

  • driver.created — New driver added
  • driver.updated — Driver details modified
  • driver.deleted — Driver removed
  • driver.status_changed — Driver status changed (Active, Inactive, On Leave, Terminated)

Customer Events

  • customer.created — New customer added
  • customer.updated — Customer details modified
  • customer.deleted — Customer removed

Equipment Events

  • equipment.created — New equipment added
  • equipment.updated — Equipment details modified
  • equipment.deleted — Equipment removed
  • equipment.assigned — Equipment assigned to a driver
  • equipment.unassigned — Equipment unassigned from driver

Settlement Events

  • settlement.created — New settlement created
  • settlement.generated — Settlement auto-generated for pay period
  • settlement.approved — Settlement approved for payment
  • settlement.paid — Settlement marked as paid
  • settlement.voided — Settlement voided

Quote Events

  • quote.created — New quote created
  • quote.status_changed — Quote status changed (Pending, Sent, Accepted, Rejected, Expired)
  • quote.converted_to_load — Quote accepted and converted to a load

Fuel Advance Events

  • fuel_advance.created — Fuel advance requested
  • fuel_advance.approved — Fuel advance approved
  • fuel_advance.issued — Fuel advance payment issued
  • fuel_advance.voided — Fuel advance voided

Document Events

  • document.uploaded — Document uploaded (BOL, POD, etc.)
  • document.verified — Document verified by reviewer
  • document.rejected — Document rejected by reviewer

Signature Events

  • signature.requested — Signature request created
  • signature.signed — Document signed (canvas)
  • signature.docusign_sent — DocuSign envelope sent
  • signature.docusign_completed — DocuSign envelope signed or declined

Compliance Events

  • driver_qualification.created — New qualification document added
  • driver_qualification.reviewed — Qualification document reviewed
  • driver_qualification.expired — Qualification document expired
  • maintenance.created — Maintenance work order created
  • maintenance.completed — Maintenance work order completed
  • maintenance.cancelled — Maintenance work order cancelled
  • dvir.created — DVIR report submitted
  • dvir.defect_corrected — DVIR defect marked as corrected

Prospecting Events

  • carrier_prospect.created — New carrier prospect added
  • carrier_prospect.pipeline_changed — Carrier prospect pipeline stage changed
  • carrier_prospect.converted — Carrier prospect converted to carrier company
  • shipper_prospect.created — New shipper prospect added
  • shipper_prospect.pipeline_changed — Shipper prospect pipeline stage changed
  • shipper_prospect.converted — Shipper prospect converted to customer

Other Events

  • message.sent — Chat message sent
  • inbound_email.received — Inbound email received
  • inbound_email.linked — Email linked to a load or customer
  • edi.204_received — EDI 204 shipment order received
  • edi.214_sent — EDI 214 status update generated
  • edi.210_sent — EDI 210 invoice generated
  • detention.created — Detention record created
  • detention.approved — Detention charges approved
  • geofence.entered — Driver entered a geofence zone
  • geofence.exited — Driver exited a geofence zone
  • test.event — Test event (fired from admin page)

EDI Management

Manage Electronic Data Interchange (EDI) document routing and trading partner configurations.

How to use it

  1. Navigate to Admin → EDI Management
  2. Configure trading partners with their EDI IDs
  3. Set up document type routing (204, 210, 214, etc.)
  4. Monitor inbound and outbound EDI transactions

Supported EDI documents

  • 204 — Motor Carrier Load Tender
  • 210 — Freight Details and Invoice
  • 214 — Shipment Status Message
  • 990 — Response to Load Tender

Integration Logs

View detailed logs of all integration activity for troubleshooting and auditing.

How to use it

  1. Navigate to Admin → Integration Logs
  2. Filter by integration type, date range, or status
  3. View request/response details for failed transactions
  4. Identify patterns in errors
  5. Re-process failed transactions when issues are resolved

Key features

  • Searchable log entries
  • Request and response payload inspection
  • Error categorization
  • Retry mechanism for failed transactions
Tip: Check integration logs regularly after enabling a new integration. Early detection of mapping issues saves time and prevents data quality problems.

User Management

Create, edit, and manage user accounts within the TMS.

How to use it

  1. Navigate to Admin → Users
  2. View all registered users with their roles and status
  3. Click a user to edit their profile, reset their password, or deactivate their account
  4. Click + New User to create an account manually
  5. Assign one or more roles to control what the user can access

Key features

  • User list with search and role filtering
  • Account activation and deactivation
  • Password reset capability
  • Role assignment per user
  • Audit trail of user changes

Role Management

Configure roles that control access to different areas of the TMS.

How to use it

  1. Navigate to Admin → Roles
  2. View all available roles and their descriptions
  3. Click a role to see which users are assigned to it
  4. Create custom roles or modify existing role permissions

Available roles

  • SuperAdmin — Full system access including role and user management
  • Admin — System configuration and integration management
  • Manager — Operational oversight and reporting
  • Customers — Customer portal access
  • Drivers — Driver-specific views and mobile app access
  • Vendors — Vendor portal access
  • User — Basic read-only access
Tip: Follow the principle of least privilege — assign users only the roles they need to perform their job functions.

Permission Management

Assign granular permissions to users beyond their role-based access.

How to use it

  1. Navigate to Admin → Permissions
  2. Select a user from the list
  3. View their current permissions across all modules
  4. Toggle individual permissions on or off
  5. Save changes — they take effect on the user's next page load

Key features

  • Module-level permission grouping
  • Read, create, edit, and delete permissions per module
  • Override role defaults for individual users
  • Permission summary view

Permission Templates

Create reusable permission templates that can be applied to users quickly.

How to use it

  1. Navigate to Admin → Permission Templates
  2. Click + New Template to create a template
  3. Name the template and configure its permissions
  4. Apply templates to users from the Permission Management page

Key features

  • Pre-built templates for common roles
  • Custom template creation
  • Bulk apply to multiple users
  • Template comparison view

Contract Templates

Manage contract and rate confirmation templates used throughout the TMS.

How to use it

  1. Navigate to Admin → Contract Templates
  2. View existing templates or create new ones
  3. Edit template content with merge fields for dynamic data
  4. Set templates as active or inactive

Key features

  • Rate confirmation templates
  • Carrier agreement templates
  • Merge field placeholders for load, customer, and driver data
  • Template versioning

API Key Management

Create and manage API keys for external system access to the TMS API.

How to use it

  1. Navigate to Admin → API Keys
  2. Click + Create API Key to generate a new key
  3. Set a name, expiration date, and permission scope for the key
  4. Copy the generated key — it is only shown once
  5. Revoke keys that are no longer needed

Key features

  • Scoped API access per key
  • Expiration date enforcement
  • Usage tracking and last-used timestamp
  • Instant revocation

Audit Log

View a comprehensive log of all user actions and system events for compliance and troubleshooting.

How to use it

  1. Navigate to Admin → Audit Log
  2. Filter by user, action type, date range, or entity
  3. Click an entry to view full details of the change
  4. Export logs to CSV for external analysis or compliance reporting

Key features

  • User action tracking (create, update, delete)
  • Login and authentication events
  • Before/after change comparison
  • CSV export for compliance
  • Searchable and filterable interface
Tip: Review the audit log regularly to monitor for unusual activity. Export logs periodically for long-term compliance records.

Site Settings

Configure system-wide settings that affect the behavior and appearance of the TMS.

How to use it

  1. Navigate to Admin → Site Settings
  2. Review and update company information (name, address, logo)
  3. Configure default values for loads, invoices, and settlements
  4. Set email notification preferences
  5. Save changes — they take effect immediately

Key features

  • Company branding and contact information
  • Default payment terms and invoice settings
  • Email and notification configuration
  • System-wide defaults for new records

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.