---
title: "Add order note when webhook received"
description: "A ready-made Shopify Flow workflow. When a 3PL, ERP or support tool calls your webhook with an order number and a message, add the message to the order note. The existing note is kept and the message goes on a new line."
canonical: "https://docs.workflow-webhooks.app/template-add-order-note"
---

# Add order note when webhook received

When a 3PL, ERP or support tool calls your webhook with an order number and a message, add the message to the order note. The existing note is kept and the message goes on a new line.

One trigger from Workflow Webhooks and Shopify's built-in actions, no other app needed.

![The workflow in Shopify Flow: Add order note when webhook received](https://cdn-dev.eu.codecreationlabs.cloud/crm-tool/uploads/SjJ78gKLnLlocopCui3Cs62dJbGZ7F1n/b6cbfb4334ef4bb7.jpg)
*The complete workflow as it looks in Shopify Flow.*

## What it needs

A webhook in Workflow Webhooks with this payload mapping. See [Payload mapping and Flow variables](https://docs.workflow-webhooks.app/payload-mapping.md).

| Field | What to map to it |
| --- | --- |
| `fieldOne` | The order number, for example `#1001` |
| `fieldTwo` | The message to add, for example `Packed by warehouse B` |

A call to the webhook then looks like this:

```bash
curl -X POST https://<your webhook URL> \
  -H "Content-Type: application/json" \
  -d '{"orderNumber": "#1001", "message": "Packed by warehouse B"}'
```

> [!WARNING]
> **More than one webhook?**
> The Webhook Trigger fires for every webhook in your store. If you have more than one, add a condition on `webhookId` **Equal to** this webhook's id right after the trigger.

## Get the workflow

1. Download the `.flow` file attached at the bottom of this page.
2. In your Shopify admin open **Flow**, click **Import** and choose the file.
3. Check the steps, then click **Turn on workflow**.

The file is an export from Shopify Flow itself. Do not edit it by hand; change the workflow in Flow after importing it.

## How it works

1. **Webhook Trigger** starts the workflow each time your webhook URL is called and hands it the mapped fields.
2. **Get order data** looks up the order with the query `name:{{fieldOne}}` and keeps at most one result.
3. **For each** runs once for the order it found, and not at all when no order matches.
4. **Update order note** writes the current note, a line break and then `{{fieldTwo}}`, so nothing already in the note is lost.

## Make it yours

- Put a date in front of the message with `{{ "now" | date: "%Y-%m-%d" }}`.
- Add **Add order tags** after the note step so the orders are easy to filter.

## Next steps

- [Create your first webhook](https://docs.workflow-webhooks.app/getting-started.md) - create the webhook this workflow listens to.
- [Workflow templates](https://docs.workflow-webhooks.app/workflow-templates.md) - all templates.
- [History and troubleshooting](https://docs.workflow-webhooks.app/history-and-troubleshooting.md) - check that the webhook reached Flow.