{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"App Store","description":"The operational transportation management API. Full access to planning, tracking, invoicing, and integrations — built on the OTM5 open data standard.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"app-store","__idx":0},"children":["App Store"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Transportial App Store lets you extend your platform with integrations, automations, and third-party tools. Apps connect external systems (telematics, ERP, accounting, board computers) to your transport operations."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-it-works","__idx":1},"children":["How It Works"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Browse"]}," the app store for available integrations"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Install"]}," an app to your platform"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Configure"]}," the app with your credentials and settings"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The app receives an ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["access token"]}," scoped to the permissions it needs"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"browsing-apps","__idx":2},"children":["Browsing Apps"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fetch available apps with optional category filtering:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.otms.transportial.com/api/app-store/browse/0/20\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Filter by category:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.otms.transportial.com/api/app-store/browse/0/20?categoryId=CATEGORY_UUID\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"totalResults\": 42,\n  \"apps\": [\n    {\n      \"id\": \"app-uuid\",\n      \"name\": \"Fleet Tracker Pro\",\n      \"description\": \"Real-time GPS tracking for your entire fleet\",\n      \"logo\": { \"url\": \"https://...\" },\n      \"publisher\": {\n        \"name\": \"Telematics Corp\"\n      },\n      \"lastVersion\": {\n        \"version\": \"2.1.0\",\n        \"releaseNotes\": \"Added geofencing support\"\n      },\n      \"category\": {\n        \"id\": \"category-uuid\",\n        \"name\": \"Telematics\"\n      }\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"installing-an-app","__idx":3},"children":["Installing an App"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://api.otms.transportial.com/api/app/{appId}/install\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you install an app:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["AppInstallation"]}," record is created for your platform"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["AppAccessToken"]}," is generated with the permissions the app requires"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The installation status transitions from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INSTALLING"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACTIVE"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You can configure app-specific settings through ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["AppInstallationSettings"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"managing-installed-apps","__idx":4},"children":["Managing Installed Apps"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["List all apps installed on your platform:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.otms.transportial.com/api/apps/installed\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"app-lifecycle","__idx":5},"children":["App Lifecycle"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INSTALLING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Installation in progress"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACTIVE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Running and connected"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UNINSTALLED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Removed from platform"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"integration-types","__idx":6},"children":["Integration Types"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Apps can power different integration types on your platform:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configured-integrations","__idx":7},"children":["Configured Integrations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Data transformation pipelines with filters and data sources. Process events automatically when transport entities change (e.g., sync a new transport order to your ERP)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"manual-integrations","__idx":8},"children":["Manual Integrations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pre-built connectors for specific platforms — board computers (Transics), payment processors (Stripe), GPS providers (EvoGPS, FleetAccess), and more."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"file-template-integrations","__idx":9},"children":["File Template Integrations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["File-based data exchange for systems that use EDI, CSV, or XML formats. Upload and download files on a schedule."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"message-automations","__idx":10},"children":["Message Automations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Automated notifications triggered by transport events — send status updates to customers, alert drivers, or notify your team when exceptions occur."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"api-access-integrations","__idx":11},"children":["API Access Integrations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Expose API endpoints for external platforms to push or pull data from your Transportial environment."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-integrations-process-data","__idx":12},"children":["How Integrations Process Data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Integrations use an event-driven queue:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A transport entity changes (order created, status updated, etc.)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IntegrationObject"]}," is added to the processing queue"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The integration scheduler (runs every ~10 seconds) picks it up"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Filters are applied to decide if the event should be processed"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Data sources transform and route the data"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Status is updated: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SUCCESS"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ERROR"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RETRY"]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Entity Change → IntegrationObject (QUEUE)\n    → Scheduler picks up\n    → Apply filters\n    → Execute data sources\n    → SUCCESS / ERROR / RETRY\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"permissions","__idx":13},"children":["Permissions"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Permission"},"children":["Permission"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["browse:app-store"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["View available apps"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["install:app"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Install apps to your platform"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get:apps"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["View installed apps"]}]}]}]}]}]},"headings":[{"value":"App Store","id":"app-store","depth":1},{"value":"How It Works","id":"how-it-works","depth":2},{"value":"Browsing Apps","id":"browsing-apps","depth":2},{"value":"Installing an App","id":"installing-an-app","depth":2},{"value":"Managing Installed Apps","id":"managing-installed-apps","depth":2},{"value":"App Lifecycle","id":"app-lifecycle","depth":2},{"value":"Integration Types","id":"integration-types","depth":2},{"value":"Configured Integrations","id":"configured-integrations","depth":3},{"value":"Manual Integrations","id":"manual-integrations","depth":3},{"value":"File Template Integrations","id":"file-template-integrations","depth":3},{"value":"Message Automations","id":"message-automations","depth":3},{"value":"API Access Integrations","id":"api-access-integrations","depth":3},{"value":"How Integrations Process Data","id":"how-integrations-process-data","depth":2},{"value":"Permissions","id":"permissions","depth":2}],"frontmatter":{"seo":{"title":"App Store"}},"lastModified":"2026-03-22T20:40:34.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/app-store","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}