Skip to main content
GHL MCP Guide
FUL

Order Fulfillment

Payments & Billing · Intermediate · Updated March 2026

Create and list fulfillment records for orders with shipping status, tracking numbers, and fulfillment progress for customer notifications.

Order Fulfillment lets you create and track shipping records for orders. When a product ships, you create a fulfillment record with the tracking number — the customer gets notified, and the order status updates to reflect the shipment.

What This MCP Tool Does

This tool handles fulfillment record creation and retrieval for specific orders. Create fulfillment entries when items ship, attach tracking numbers, and list all fulfillments for an order to see its shipping history.

Endpoint Reference

Create a fulfillment: POST /payments/orders/{orderId}/fulfillments Create a new fulfillment record with tracking number, carrier, and shipped items.

List fulfillments for an order: GET /payments/orders/{orderId}/fulfillments Retrieve all fulfillment records associated with an order.

Authentication

Requires a Private Integration Token (PIT) with the payments scope enabled.

Key Parameters

When creating a fulfillment:

  • trackingNumber — carrier tracking number
  • carrier — shipping carrier name
  • items — which order items are included in this shipment
  • notifyCustomer — whether to send a shipping notification

Important Notes

An order can have multiple fulfillment records for partial shipments. If an order contains three items and two ship first, create one fulfillment for those two. When the third ships, create a second fulfillment.

Tracking numbers connect to the carrier specified. Ensure the carrier name matches what GHL expects so tracking links generate correctly for customer notifications.

For agencies automating fulfillment, this endpoint pairs with the Order Manager to detect new orders and the Carrier Manager for carrier-specific tracking.

Common Questions

Can I update a fulfillment after creating it? Check the API for update capabilities. If updates are not supported, ensure tracking information is correct before creating the fulfillment record.

Does creating a fulfillment notify the customer automatically? Depending on configuration, the customer may receive a notification with tracking information. Check the notifyCustomer parameter and location notification settings.

How do I handle returns or canceled shipments? Fulfillment records track outbound shipments. Returns and cancellations are typically handled through separate order status updates or refund processes.

Back to GHL MCP Guide