Handle create events

Ingest orders Otter created internally (integrations or manual entry) into your POS or back office.

Before you begin

• Webhook receiver for Orders creation (orders.new_order) events
• Keep webhooks secure
• Async processing path if you cannot finish within the webhook timeout

Steps

1. Otter sends an Orders creation (orders.new_order) webhook with the order payload.
2. Respond with:

• HTTP 200 — processed synchronously, or
• HTTP 202 — accepted for async processing; when finished, acknowledge with POST /manager/order/v1/orders/order-created (scope manager.orders), sending the original webhook’s X-Event-Id.

3. On failure, report via POST /v1/callback/error.

Verify

Trigger a create event; your system shows the order and Otter receives 200/202 as appropriate.

Next

• Handle status notifications
• Orders (receive) overview