Internal Couriers
Your organization's own delivery fleet — managed directly through the Deliverty Hub dashboard.
What Are Internal Couriers?
An internal courier represents your organization's in-house delivery capability. When you create an internal courier, you are telling the platform that your organization has its own fleet of agents who can fulfill delivery tasks directly, without relying on any third-party service.
Every organization in Deliverty Hub can have one or more internal couriers. When a task is assigned to an internal courier, the platform's assignment engine selects an available agent from your organization's pool and dispatches the task to them through the Deliverty Driver App.
Internal couriers use your own agents and are fully managed within Deliverty Hub. External couriers, by contrast, represent third-party delivery providers whose APIs are integrated via the courier plugin system. You can use both types simultaneously and choose per-task which courier handles a delivery.
How Internal Couriers Work
The internal courier acts as a bridge between tasks and your agents. Here is the typical flow:
Task Created
A new delivery task is created (from the dashboard or via API). The task is in NEW status.
Courier Selected
The internal courier is selected for this task — either manually by a dispatcher or automatically based on configuration. The task moves to AWAITING_ASSIGNMENT.
Agent Assignment
The assignment engine evaluates available agents and assigns the best candidate based on the configured algorithm (nearest, load-balanced, etc.). The task moves to ASSIGNED.
Agent Accepts
The agent receives a push notification on the mobile app, reviews the task details, and accepts the assignment. The task moves to ACCEPTED.
Delivery Executed
The agent picks up the package, travels to the destination, and marks the task as complete. The full status flow is ACCEPTED → IN_TRANSIT → COMPLETED.
Internal Courier Properties
Each internal courier record has the following properties:
| Field | Type | Description |
|---|---|---|
name |
String | Display name for this courier (e.g., "Main Fleet", "Express Team") |
type |
Enum | Always INTERNAL for internal couriers |
status |
Enum | Operational status: ACTIVE, PENDING, BLOCKED, or IN_REVIEW |
organization |
Organization | The organization this courier belongs to |
isActive |
Boolean | Whether this courier is currently accepting tasks |
Creating an Internal Courier
To set up an internal courier for your organization:
- Navigate to Fleet > Couriers in the dashboard.
- Click Add Courier and select the Internal type.
- Enter a name for the courier (e.g., "Main Fleet" or "Same-Day Team").
- The courier is created in
ACTIVEstatus and is immediately ready to receive tasks.
You can create multiple internal couriers within the same organization to represent different teams or service tiers (e.g., a "Standard" fleet and an "Express" fleet). Each courier can be selected independently when dispatching tasks.
The Agent Pool
Internal couriers draw from the same pool of agents within your organization. When a task is routed to an internal courier, the assignment engine considers all available agents in the organization — not just agents tied to a specific courier.
This means:
- All agents registered in your organization are eligible candidates for any internal courier task.
- The assignment algorithm determines which specific agent receives the task based on proximity, workload, or other configured criteria.
- Agents do not need to be explicitly "attached" to a particular internal courier — the assignment is handled automatically.
When to Use Internal vs External Couriers
| Scenario | Recommended Courier Type |
|---|---|
| You have your own delivery drivers with the Deliverty app | Internal |
| You need full control over assignment, tracking, and agent management | Internal |
| You want to use a third-party logistics provider | External |
| Your own fleet is at capacity and you need overflow capacity | External (as fallback) |
| You need deliveries in regions where you have no agents | External |