Every South African e-commerce business reaches a tipping point. At first, manually booking each courier delivery is manageable. But as order volumes grow — 20 orders a day, then 50, then 200 — the manual process becomes a bottleneck that costs you time, money, and customer satisfaction. Staff spend hours each morning copying addresses into courier booking forms. Errors creep in. Dispatch is delayed. Customers complain.
UrgentGo's API integration was built to eliminate this problem entirely. By connecting your e-commerce platform directly to UrgentGo's dispatch system, every order automatically triggers a courier booking — with zero manual input required. This guide explains exactly how the integration works, what it enables, and how to get started.
What Is the UrgentGo API?
An API (Application Programming Interface) is essentially a bridge that allows two software systems to communicate with each other. UrgentGo's API is a set of secure, documented endpoints that allow your e-commerce platform, order management system, or custom-built software to send and receive data from UrgentGo's dispatch infrastructure in real time.
In practical terms: when a customer completes a purchase on your website, your system sends the order details to UrgentGo's API, which instantly creates a courier booking, assigns a driver, and returns a tracking number — all without anyone on your team lifting a finger.
What the UrgentGo API Can Do
- Auto-create bookings — triggered instantly when an order is placed
- Retrieve live tracking — pull real-time delivery status into your own dashboard
- Fetch proof of delivery — automatically attach POD documents to order records
- Check wallet balance — monitor spend and trigger top-up alerts programmatically
- Bulk dispatch — submit hundreds of bookings simultaneously via a single API call
- Get rate quotes — calculate delivery costs programmatically before confirming a booking
- Cancel or modify bookings — update delivery details without manual intervention
The Problem With Manual Dispatch (And Why It Scales Badly)
To understand why API integration matters, it helps to map out what manual dispatch actually looks like at scale. Here's a typical morning for an e-commerce business processing 80 orders per day without automation:
A Typical Manual Dispatch Morning (80 Orders)
Total time lost: ~3.5 hours. Staff cost. Errors. Delayed dispatch. Unhappy customers.
Now multiply this across 250 working days per year. That's 875 hours — over 21 full working weeks — spent on a task that the UrgentGo API can handle in seconds.
How UrgentGo API Integration Works: Step by Step
The integration process is straightforward. Here's exactly what happens from the moment a customer places an order to the moment their parcel is collected:
Customer Places an Order
A customer completes checkout on your Shopify, WooCommerce, or custom store. The order is confirmed and payment is processed as normal.
Your System Sends Order Data to UrgentGo API
Your integration layer (plugin, webhook, or custom code) automatically sends the delivery address, parcel dimensions, weight, and service type to UrgentGo's API endpoint.
UrgentGo Creates the Booking Instantly
UrgentGo's system validates the data, calculates the cost, deducts it from your wallet, and creates a confirmed courier booking — typically within 2–3 seconds.
Tracking Number Returned to Your System
The API returns a unique tracking number and waybill. Your system automatically updates the order record and sends the tracking link to your customer via email or SMS.
Driver Assigned & Collection Scheduled
UrgentGo's dispatch system assigns the nearest available driver. For same-day orders, collection typically begins within 60–90 minutes of booking.
POD Auto-Attached on Delivery
Once delivered, the proof of delivery (signature or photo) is automatically pushed back to your system via webhook — no manual retrieval needed.
Platform Compatibility: What We Integrate With
UrgentGo's API is platform-agnostic — it works with any system that can make HTTP requests. That said, we've built dedicated plugins and integration guides for the most popular South African e-commerce platforms:
Shopify
Native plugin available. Install, connect your API key, and go live in under 30 minutes.
WooCommerce
WordPress plugin with full order sync, label printing, and tracking auto-send.
Magento
Extension available for Magento 2.x with bulk dispatch and rate-at-checkout support.
Custom Platforms
Full REST API documentation provided. Integrate with any custom-built system.
Takealot Sellers
Automate fulfilment for Takealot marketplace orders via our seller integration guide.
ERP Systems
SAP, Sage, and Syspro integrations available for enterprise-level order management.
Real-Time Tracking Inside Your Own Platform
One of the most powerful features of the UrgentGo API is the ability to embed live tracking data directly into your own customer-facing interfaces. Instead of redirecting customers to a third-party tracking page, you can display real-time delivery status — driver location, estimated arrival time, and delivery confirmation — right inside your own website or app.
This creates a significantly better customer experience. Customers stay on your platform, your brand remains front and centre, and you reduce the volume of "where is my order?" support queries by giving customers instant, self-service visibility.
Customer Experience Impact
Businesses that implement branded tracking pages report up to a 35% reduction in "where is my order?" support tickets — simply by giving customers real-time visibility through the UrgentGo tracking API. Fewer support queries means lower operational costs and higher customer satisfaction scores.
Bulk Dispatch: Sending Hundreds of Orders at Once
For high-volume e-commerce businesses, the bulk dispatch endpoint is a critical feature. Instead of triggering individual API calls per order, you can submit a batch of hundreds of bookings in a single API request — ideal for businesses that process orders in batches at set times of day.
How Bulk Dispatch Works
- Compile your pending orders into a structured JSON payload or CSV file
- Submit the batch to UrgentGo's bulk booking endpoint
- Receive a batch confirmation with individual tracking numbers for each order
- Your system automatically updates all order records simultaneously
- A single consolidated waybill manifest is generated for your records
Bulk dispatch is particularly valuable for businesses that fulfil orders once or twice daily — for example, processing all overnight orders at 6am and all same-day orders at noon. The entire batch is dispatched in seconds rather than hours.
Rate-at-Checkout: Show Delivery Costs Before Purchase
UrgentGo's API also includes a rate calculation endpoint that allows you to display accurate, real-time delivery costs to customers during checkout — before they complete their purchase. This is a significant conversion optimisation feature.
When a customer enters their delivery address at checkout, your platform calls the UrgentGo rate API with the destination, parcel dimensions, and weight. The API returns available service options (same-day, overnight, economy) with accurate pricing. The customer selects their preferred option, and the exact cost is added to their order total.
| Service Option | Delivery Time | Best For | API Endpoint |
|---|---|---|---|
| Urgent Same-Day | Within 60–90 min | Time-critical orders | /rates/same-day |
| Express Overnight | Next business day | Standard e-commerce | /rates/overnight |
| Economy National | 2–4 business days | Cost-sensitive shipments | /rates/economy |
| Air Freight | Same or next day | Long-distance urgent | /rates/airfreight |
Security & Reliability: Built for Production
UrgentGo's API is built to enterprise-grade standards. Every integration uses API key authentication with optional IP whitelisting. All data is transmitted over HTTPS with TLS 1.3 encryption. The API maintains 99.9% uptime with redundant infrastructure across multiple data centres.
API Key Authentication
Unique API keys per integration with granular permission scopes. Rotate keys at any time without downtime.
TLS 1.3 Encryption
All data in transit is encrypted using the latest TLS standard. No plain-text transmission of sensitive data.
99.9% Uptime SLA
Redundant infrastructure ensures your dispatch automation never goes offline during peak trading periods.
Webhook Notifications
Real-time push notifications for booking confirmations, status updates, and delivery completions.
Full Audit Logging
Every API call is logged with timestamps, request payloads, and response codes for debugging and compliance.
Sub-3 Second Response
Booking creation, rate queries, and tracking updates all return within 3 seconds under normal load.
The Business Case: What Automation Actually Saves You
Let's put real numbers to the value of API-driven dispatch automation. Consider a mid-sized South African e-commerce business processing 150 orders per day:
ROI Calculation: 150 Orders/Day
Without API Integration
With UrgentGo API
Estimated Annual Saving: R202,500+ in staff costs alone
Excluding savings from faster dispatch, fewer errors, and reduced customer support queries
Getting Started: How to Integrate the UrgentGo API
API access is available to all UrgentGo Business Account holders on the Business and Enterprise tiers. Here's how to get your integration live:
Open a Business Account
If you don't already have one, apply for a UrgentGo Business Account. Approval typically takes one business day.
Request API Access
Contact your account manager or submit a request through your dashboard. API credentials are issued within 24 hours.
Access the Developer Documentation
Our full API documentation covers every endpoint, request format, response schema, and error code. Sandbox environment included for testing.
Install the Plugin or Build Your Integration
Use our ready-made Shopify or WooCommerce plugin for a no-code setup, or build a custom integration using our REST API documentation.
Test in Sandbox
Run your integration against our sandbox environment to verify booking creation, tracking retrieval, and webhook delivery before going live.
Go Live with Onboarding Support
Our technical team reviews your integration and confirms it's working correctly before you switch to live mode. We're with you every step of the way.
Who Is API Integration Right For?
API integration delivers the most value for businesses that meet one or more of the following criteria:
- Processing 20+ orders per day — at this volume, manual booking becomes a meaningful time drain
- Running an e-commerce store on Shopify, WooCommerce, Magento, or a custom platform
- Operating a marketplace or multi-vendor platform where sellers need automated fulfilment
- Managing a subscription box or recurring delivery business with predictable batch dispatch
- Running a B2B distribution operation where orders are generated by an ERP or order management system
- Building a logistics-adjacent product that needs courier functionality embedded within it
If you're still manually booking couriers and your order volume is growing, the question isn't whether to automate — it's how quickly you can get the integration live.
Frequently Asked Questions
Do I need a developer to integrate the UrgentGo API?
For Shopify and WooCommerce, no developer is required — our plugins are designed for non-technical users and can be configured through a simple settings panel. For custom integrations, basic development knowledge is needed, but our documentation is comprehensive and our technical team provides onboarding support.
Is there an additional cost for API access?
API access is included at no additional charge for Business and Enterprise tier account holders. There are no per-call fees or API usage charges — you only pay for the courier bookings you create.
Can I test the integration before going live?
Yes. UrgentGo provides a full sandbox environment that mirrors the production API. You can create test bookings, simulate tracking updates, and test webhook delivery without incurring any charges or creating real courier jobs.
What happens if the API is unavailable when an order is placed?
Our API maintains 99.9% uptime. In the rare event of a temporary outage, our recommended integration pattern includes a retry queue — orders are held and automatically submitted once connectivity is restored. No orders are lost.
Can I use the API to book multiple service types from one integration?
Yes. A single API integration gives you access to all UrgentGo service types — same-day, overnight, economy, air freight, and more. You can dynamically select the service type per order based on your business rules.
Is the API available for international shipments?
Yes. UrgentGo's international shipping services are accessible via the API. You can create international bookings, retrieve customs documentation requirements, and track cross-border shipments programmatically.