Every action below is available as a verb in Cerebral OS — callable from a Cerebral, a Map, or the Runtime API. All executions are governed, audited, and dry-run safe.
Add Order Note
shopify:add_order_note
Add or update an internal staff note on an order (not visible to customer). Use for documenting actions taken, escalation notes, or internal context. Warning: This replaces the existing note, doesn't append to it.
Write
Low risk
Apply Discount
shopify:apply_discount
Create a discount code for an existing price rule (step 2 of 2-step process). Must call shopify_create_discount first to get the price_rule_id. This generates the actual code customers type at checkout.
Write
Low risk
Cancel Order
shopify:cancel_order
Cancel an order and optionally issue refund and send notification. Only works on orders that haven't been fulfilled yet - already-shipped orders cannot be cancelled. Use shopify_refund_order separately for already-fulfilled orders.
Write
High risk
Complete Draft
shopify:complete_draft
Convert a draft order into a real order (finalizes the draft). Use after creating and customizing draft with shopify_create_draft_order. Once completed, draft becomes an actual order and cannot be edited as draft anymore.
Write
High risk
Create Discount
shopify:create_discount
Create a discount price rule in Shopify (step 1 of 2-step process). After creating, use shopify_apply_discount to generate the actual discount code customers use. This creates the discount configuration, not the code itself.
Write
Medium risk
Create Draft Order
shopify:create_draft_order
Create a draft order that can be customized before converting to real order. Use for manual orders, quotes, or custom pricing before sending invoice. Must call shopify_complete_draft to convert to actual order.
Write
Medium risk
Get Customer
shopify:get_customer
Get full customer details including addresses and order history. Requires customer_id from shopify_get_customers search (use email search first to get ID). Returns more detailed information than shopify_get_customers including full address book.
Read
Low risk
Get Customers
shopify:get_customers
Search for customers by email, name, or phone. Returns customer IDs needed for order lookups. Query auto-detects type: email (contains @), phone (all digits), or name search. Use shopify_get_customer for full details after finding the customer ID.
Read
Low risk
Get Fulfillment Events
shopify:get_fulfillment_events
Get tracking events for a fulfillment - includes delivery status for all carriers including Amazon This is the ONLY reliable way to check if Amazon orders are delivered
Read
Low risk
Get Order
shopify:get_order
Get complete order details including customer, line items, fulfillment, and tracking. Auto-detects order ID format (order name vs internal ID) and retrieves full details. Use after finding order with shopify_get_orders to get shipping/tracking info.
Read
Low risk
Get Orders
shopify:get_orders
Search for orders by customer, order number, status, or date range. Returns order list with summary info - use shopify_get_order for full details. CRITICAL: When user says "order 1176", add "#" prefix → name: "#1176"
Read
Low risk
Refund Order
shopify:refund_order
Issue a refund for specific line items in an order. Must call shopify_get_order first to get the line_item_id. Can refund full or partial quantities of individual line items.
Write
High risk
Search Orders by Tag (GraphQL)
shopify:search_tags_graph
Search orders by tag using GraphQL (more reliable than REST tag filtering). Returns orders in REST-compatible format sorted newest first. Use for entry points and workflows that filter by tags.
Read
Low risk
Send Invoice
shopify:send_invoice
Send an invoice email for a draft order to customer. Customer receives payment link to complete the order. Use after creating draft order with shopify_create_draft_order.
Write
Medium risk
Add Order Tags (GraphQL)
shopify:tags_add_graph
Add tags to order WITHOUT replacing existing tags (GraphQL only feature). Much cleaner than REST which requires GET current tags, modify, then PUT. Use for workflow stages, priority markers, or categorization.
Write
Low risk
Remove Order Tags (GraphQL)
shopify:tags_remove_graph
Remove specific tags from order WITHOUT affecting other tags (GraphQL only feature). Much cleaner than REST which requires GET current tags, modify, then PUT. Use for clearing workflow stages or removing temporary markers.
Write
Low risk
Update Address
shopify:update_address
Update a customer's address in their address book. Use shopify_get_customer first to get available address_id values. Only updates fields that are provided - omitted fields remain unchanged.
Write
Low risk
Update Customer
shopify:update_customer
Update customer contact information, tags, notes, or marketing preferences. Phone numbers auto-formatted to E.164 for US numbers (adds +1 country code). Use shopify_get_customers first to find customer_id by email.
Write
Low risk
Update Draft Order
shopify:update_draft_order
Update line items in a draft order before completing it. Use between shopify_create_draft_order and shopify_complete_draft. Allows modifying products, quantities, or pricing before finalizing.
Write
Medium risk
Update Fulfillment
shopify:update_fulfillment
Add tracking information to an order fulfillment (marks order as shipped). Use when shipping carrier provides tracking number. Customer receives tracking link via email if notify_customer is true.
Write
Medium risk
Update Marketing Consent
shopify:update_marketing_consent
Update customer's marketing email consent preferences. Use when customer opts in/out of marketing emails or to comply with GDPR/privacy laws. Typical usage: accepts_marketing=true + state="subscribed" + opt_in_level="confirmed_opt_in"
Write
Low risk
Update Order
shopify:update_order
Update order details including shipping address, notes, tags, or email. PRIMARY USE: Update shipping address before order ships. CRITICAL: Cannot update address after order is fulfilled/shipped - check fulfillment_status first.
Write
Medium risk
Update Order Tags
shopify:update_order_tags
Update order tags (for categorization, workflow tracking, or filtering). Warning: Replaces ALL existing tags - doesn't append. Get current tags first if adding. Use for: priority marking, workflow stages, internal categorization.
Write
Low risk
Validate Discount
shopify:validate_discount
Validate if a discount code is valid and active. Checks: code exists, currently active (not expired), hasn't exceeded usage limits. Returns validation status and discount details (value, type, restrictions).
Read
Low risk