✅ Item Availability

🧾 Description

This document describes the item_availability event that Blend sends to delivery platforms
to show or hide a specific item on a merchant's menu.

This is useful when a product is temporarily out of stock or being brought back into availability.

🔁 Trigger

This event is triggered when a merchant or admin updates the availability status of an item.

🧭 How to Change Item Availability from Dashboard

Use the Blend dashboard to change item visibility with no API calls.

🔐 Step 1: Login

Go to https://bm-staging.tryblend.net/
Login using your Blend credentials.

📋 Step 2: Open the Menu Page

From the sidebar, go to Menu

🍔 Step 3: Enter the Items Tab

Select the menu you want to edit and click on the Items tab.

✏️ Step 4: Edit Item

Find the item you want to update and click Edit.

📦 Step 5: Manage Availability

On the upper right of the item form, you will see a section called Availability.
Click the Edit icon inside that section.

Toggle the item availability using the switch
Click Save

🚀 Step 6: Blend Pushes Event

Blend will automatically fire the item_availability event to the delivery app’s webhook.

🧩 JSON Payload

{
  "event": "item_availability",
  "event_time": "2025-01-01 00:00:00",
  "branch_id": "14589",
  "payload": {
    "item_id": "1",
    "is_available": false
  }
}

🗂 Field Descriptions

Field	Description
`event`	Always `"item_availability"` — type of event
`event_time`	Timestamp of when the toggle action occurred
`branch_id`	The branch that owns the item
`payload.item_id`	The internal or shared ID of the item being updated
`payload.is_available`	Boolean: `true` to show the item, `false` to hide it

🧠 Behavior

If is_available = false → Blend will instruct the delivery app to hide this item.
If is_available = true → Blend will make the item visible again on the menu.
This does not delete or remove the item, only toggles its availability.

🔧 Example Use Cases

Branch runs out of shawarma → Merchant disables it
Branch re-stocks drinks → Admin enables the drink item
Scheduled product availability → automation triggers change

✅ Notes

This event does not update the full item object — only its visibility
If the delivery app does not support item-level toggling, this event may be ignored
This is a lightweight payload, perfect for real-time menu updates