Get notified when an order changes
subscribe_order_updatesFor agents that can receive webhooks: registers an https URL that Fold POSTs to on every status change of one order (picked up, washing, out for delivery, delivered…). Payload: {event:"order.status_changed", orderCode, state, statusLabel, statusDescription, occurredAt}. Header Fold-Signature: t=,v1=<hex HMAC-SHA256 of "t.body" with the returned secret>. Works with the connected account or order code + the email used when scheduling. Max 3 per order.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"orderCode": "<orderCode>",
"webhookUrl": "<webhookUrl>"
},
"name": "subscribe_order_updates"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| No | Not needed with a connected account. | ||
| orderCode | Yes | ||
| webhookUrl | Yes | Public https URL. |