Using Final Mile Photos with McLeod TMS
To get started using Final Mile Photos with McLeod TMS, create an account by following the first three steps at Getting Started with the API Hub.
Quick Start Checklist
- Create a Liminal Network Account
- Add McLeod TMS Credentials
- Configure Final Mile Photos Driver Page
- Configure McLeod Webhook
- Testing
McLeod TMS Credentials
After setting up your account and billing info, go to the credentials page.
Select McLeod TMS from the dropdown, then add either your username/password or authentication token.
After saving, your account will show the credentials have been stored:
Final Mile Photos Upload Configuration
The next step is to set up Final Mile Photos. This customizes the page drivers see when uploading photos. When you log in, you’ll see:
Image types are mapped to McLeod document types by default:
- Bill Of Lading -> 1
- Weight Receipt -> 4
- Delivery Receipt -> 19
- Proof Of Delivery -> 19
- Picture of Freight ->12
- Picture of Freight Problem -> 13
After configuring Final Mile Photos and saving, the Magic Link will appear at the top of the page.
This link is specific to your company and is the link drivers will use to upload pictures.
The Magic Link has three components – https://m.finalmile.photos/middlesection/anything
- The initial website – https://m.finalmile.photos
- Information specific to your company – /middlesection
- Order ID – /anything
Putting an Order ID behind https://m.finalmile.photos/middlesection/ creates a unique link that allows Final Mile Photos to push photos directly to McLeod and attach them to the Order ID used in the magic link.
An example of the magic link for order 12345 would be https://m.finalmile.photos/middlesection/12345.
Webhook to McLeod TMS
The webhook instructs Final Mile Photos where to send updates. For the webhook configuration.
You will need to:
- Select 3a to send images as they are submitted
- Add your Post-To URL (from your McLeod instance)
- Select how you want to handle images identified as potentially sensitive
Note: McLeod TMS credentials must be added before configuring the McLeod TMS Imaging Service Webhook.
After submitting your webhook configuration, you can view existing webhooks:
Testing Final Mile Photos & McLeod TMS
To test Final Miles Photos with McLeod TMS, copy the Magic Link from the configuration page.
Modify your Magic Link by changing /anything on the end to your reference number. This will allow you to see your configured driver upload page – which is also Liminal’s demo page.
After the required images have been uploaded, thumbnails and a submit button will appear.
If there are any issues with the submission, the user will be directed to retake and upload the new images.
Multiple Documents for one Reference Number
Final Mile Photos allows users to reuse a specific Magic link by adding additional images. Liminal’s internal reporting tags the images with – – 2, – – 3, etc. To avoid confusion, but still sends them to McLeod with the original order number.
- https://m.finalmile.photos/middlesection/12345 – – 2
Use Reporting to Verify Results
You can browse uploaded images, download reports, and view webhook status by visiting the Photos Report page. A sample report is below:
Clicking the links in the Ref # column will take you to a detailed report page:
All images are full color, documents up to 300k bytes are resized to at most 1024×1024 pixels, and freight images up to 100k bytes are resized to at most 640×640 pixels.
You can use Push Current Image to webhook to resend an image. After an image has been sent, you can see the first 64 bytes of your configured webhook’s response.
Last Updated | March 27, 2025
Final Miles Documentation