What is Blend?

Blend is a unified API platform that connects with major delivery apps across Saudi Arabia, including Jahez, HungerStation, Careem Food, Noon, and Ninja.

Merchants use Blend to control and synchronize their branch data across all delivery apps from a single backend.

🧩 Supported Integrations

Blend supports two types of integrations:

1. Public APIs

For apps like Jahez and Careem that offer their own public APIs, Blend connects directly and handles all synchronization logic.

2. Private APIs (Proxy Layer)

For platforms without APIs, Blend provides a private gateway that allows store owners to manage their branches indirectly via Blend.

🚀 Main Features

Feature	Direction	Description
Sync Menu	Blend → Delivery App	Send full menu structure from Blend to the delivery app
Item Visibility	Blend → Delivery App	Hide/show specific items
Branch Pause	Blend → Delivery App	Pause/unpause the branch
Order Created (Webhook)	Delivery App → Blend	Blend receives orders via webhooks
Update Order Status	Bidirectional	Blend and delivery apps can update order status (accepted, rejected, etc.)

🔐 IP Whitelist Requirement

To ensure secure communication, delivery partners must provide Blend with their public IP address(es) to whitelist.
This is required for :

Posting order creation or order updates to Blend

Please contact Blend support with your IP list before integration testing.

🏜️ Sandbox Requirement

Implementation Requirements

Inbound Webhooks

Please implement all requirements described in the API documentation. The following inbound webhooks must be implemented on your side using the exact request and response structures defined in the documentation:

Menu Synchronization
Item Availability Updates
Branch Availability Updates
Order Status Updates

Please provide a single webhook URL that Blend can use to send all of the above events.

Outbound APIs/Webhooks

In addition, you must implement the outbound APIs/webhooks that Blend expects to receive from your system, following the same request and response formats specified in the documentation, including:

Order Created
Order Status Updates

Next Steps

Once we have verified that all required integrations are working correctly in the sandbox environment, we will provide you with:

Sandbox account credentials
The Blend webhook URL that your system should use to send events to Blend

🔄 Event Direction Summary

→ = Blend triggers event to Delivery App  
← = Blend receives event from Delivery App  
↔ = Both directions (request & response)

Menu Sync: →
Item Visibility: →
Branch Pause: →
Order Create: ←
Order Status Update: ↔

🧪 Test Endpoints

You can simulate delivery app behaviors (e.g., sending a webhook to Blend) using tools like Postman or curl.

Example:

curl -X POST blend_webhook_url \
  -H "Content-Type: application/json" \
  -d '{
    "order_id": "123456",
    "status": "new",
    "items": [...]
  }'

🧭 Overview