Hybrid API Integration

Send a single POST request to create a delivery, then manage everything else through the dashboard.

1 API Call

Overview

The Hybrid integration is perfect for developers who want to automate delivery creation from their application while managing operations through the dashboard. You only need one API call to create a delivery, everything else happens in the UI.

Creating a Delivery

Use the POST /v1/deliveries endpoint to create a new delivery:

create-delivery.sh
curl -X POST https://api.send247.uk/v1/deliveries \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "business_id": "d9980ab3-5676-4bd8-b69d-c24415d78c72",
    "delivery_mode": "d42731fd-88a4-4d8f-9e56-dd81640e9d35",
    "recipients": [
      {
        "name": "John Doe",
        "postal_code": "EC2A",
        "address": "651 N Broad Street",
        "phone_number": "+4478373839",
        "order_id": "S247-ASD-WUI",
        "note": "Drop it at my door"
      }
    ]
  }'

Response

A successful request returns the delivery details including a tracking URL you can share with your customer:

response.json
{
   "status":"success",
   "data":[
      {
         "_id":"b9bd2747-c4fa-48d8-8a88-d7327f7da186",
         "order_id":"S247-ASD-W917",
         "reference":"CD-C4FA-48D8-8A88",
         "created_at":"2026-01-30T13:13:49.105Z",
         "updated_at":"2026-01-30T13:13:49.105Z",
         "status":"pending",
         "delivery_mode":"car",
         "recipient":{
            "name":"John Doe",
            "postal_code":"100001",
            "note":"test"
         }
      }
   ]
}

💡 What happens next?

Once created, the delivery appears in your dashboard where you can track progress, view photo proof, and manage any issues. No additional API calls needed!