---
title: "Submit request for fulfillment"
description: "Fulfillment order submitted request"
doc_type: openapi
doc_category: openapi
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/docs/webhook/order/submit-request-for-fulfillment'
  md: 'https://developer.shopline.com/docs/webhook/order/submit-request-for-fulfillment.md'
---
# Submit request for fulfillment

Fulfillment order submitted request

- **API Version:** v20270301
- **API Type:** Webhook
- **API Protocol:** RESTful

## Request

### Request Headers

* `X-Shopline-Topic`

  string (required)

  The unique identifier for the event.

* `X-Shopline-Hmac-Sha256`

  string (required)

  The signature of the request. Upon receiving the request, you must [verify the signature](https://developer.shopline.com/docs/apps/api-instructions-for-use/generate-and-verify-signatures.md#post-requests) to confirm the authenticity and integrity of the data.

* `X-Shopline-Shop-Domain`

  string (required)

  The store domain.

* `X-Shopline-Shop-Id`

  string (required)

  The store ID.

* `X-Shopline-Merchant-Id`

  string (required)

  The merchant ID.

* `X-Shopline-API-Version`

  string (required)

  The API version.

* `X-Shopline-Webhook-Id`

  string (required)

  The ID of this Webhook event.

### Request Body

* `fulfillment_order_merchant_request`

  object

  Requirements for performance

  * `message`

    string

    Notes

  * `notify_customer`

    boolean

    Notify customers whether or not

* `original_fulfillment_order`

  object

  Original order information

  * `id`

    string

    Identifies id

  * `requestStatus`

    string

    Request status

  * `status`

    string

    Performance-date status

* `submitted_fulfillment_order`

  object

  Information on the order

  * `id`

    string

    Identifies id

  * `request_status`

    string

    Request status

  * `status`

    string

    Performance-date status

## Response

### Status Codes

* `200`

  After receiving a webhook notification from SHOPLINE, you must respond with the following format: 
  
  ``` HTTP/1.1 200 OK ```
  
  For more information about how to subscribe to webhooks and webhook response rules, refer to [Webhook overview](https://developer.shopline.com/docs/apps/api-instructions-for-use/webhooks/overview.md).

### Response Body

#### 200

_No response body_

## OpenAPI Definition

```json
{
  "description": "Fulfillment order submitted request",
  "externalDocs": {
    "description": "| Event Group | Event Identification |\n| :------: | :------: |\n|fulfillment_order        |fulfillment_order/submitted        |\n",
    "url": "",
    "errorTableDescription": ""
  },
  "operationId": "mec0nQg6",
  "parameters": [
    {
      "name": "X-Shopline-Topic",
      "in": "header",
      "description": "The unique identifier for the event.",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Topic",
        "description": "The unique identifier for the event.",
        "type": "string",
        "example": "orders/edited"
      },
      "example": "orders/edited"
    },
    {
      "name": "X-Shopline-Hmac-Sha256",
      "in": "header",
      "description": "The signature of the request. Upon receiving the request, you must [verify the signature](https://developer.shopline.com/docs/apps/api-instructions-for-use/generate-and-verify-signatures.md#post-requests) to confirm the authenticity and integrity of the data.",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Hmac-Sha256",
        "description": "The signature of the request. Upon receiving the request, you must [verify the signature](https://developer.shopline.com/docs/apps/api-instructions-for-use/generate-and-verify-signatures.md#post-requests) to confirm the authenticity and integrity of the data.",
        "type": "string",
        "example": "XWmrwMey6OsLMeiZKwP4FppHH3cmAiiJJAweH5Jo4bM="
      },
      "example": "XWmrwMey6OsLMeiZKwP4FppHH3cmAiiJJAweH5Jo4bM="
    },
    {
      "name": "X-Shopline-Shop-Domain",
      "in": "header",
      "description": "The store domain.",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Shop-Domain",
        "description": "The store domain.",
        "type": "string",
        "example": "example.myshopline.com"
      },
      "example": "example.myshopline.com"
    },
    {
      "name": "X-Shopline-Shop-Id",
      "in": "header",
      "description": "The store ID.",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Shop-Id",
        "description": "The store ID.",
        "type": "string",
        "example": "1610418123456"
      },
      "example": "1610418123456"
    },
    {
      "name": "X-Shopline-Merchant-Id",
      "in": "header",
      "description": "The merchant ID.",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Merchant-Id",
        "description": "The merchant ID.",
        "type": "string",
        "example": "2000001234"
      },
      "example": "2000001234"
    },
    {
      "name": "X-Shopline-API-Version",
      "in": "header",
      "description": "The API version.",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-API-Version",
        "description": "The API version.",
        "type": "string",
        "example": "v20250601"
      },
      "example": "v20250601"
    },
    {
      "name": "X-Shopline-Webhook-Id",
      "in": "header",
      "description": "The ID of this Webhook event.",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Webhook-Id",
        "description": "The ID of this Webhook event.",
        "type": "string",
        "example": "b54557e48a5fbf7d70bcd043"
      },
      "example": "b54557e48a5fbf7d70bcd043"
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "properties": {
            "fulfillment_order_merchant_request": {
              "name": "fulfillment_order_merchant_request",
              "description": "Requirements for performance",
              "type": "object",
              "properties": {
                "message": {
                  "name": "message",
                  "description": "Notes",
                  "type": "string",
                  "example": "\"Fragile\""
                },
                "notify_customer": {
                  "name": "notify_customer",
                  "description": "Notify customers whether or not",
                  "type": "boolean",
                  "example": true
                }
              },
              "example": {
                "message": "\"Fragile\"",
                "notify_customer": true
              }
            },
            "original_fulfillment_order": {
              "name": "original_fulfillment_order",
              "description": "Original order information",
              "type": "object",
              "properties": {
                "id": {
                  "name": "id",
                  "description": "Identifies id",
                  "type": "string",
                  "example": "\"21057401932826316666967110_4005740193290131085320\""
                },
                "requestStatus": {
                  "name": "requestStatus",
                  "description": "Request status",
                  "type": "string",
                  "example": "\"unsubmitted\""
                },
                "status": {
                  "name": "status",
                  "description": "Performance-date status",
                  "type": "string",
                  "example": "\"open\""
                }
              },
              "example": {
                "id": "\"21057401932826316666967110_4005740193290131085320\"",
                "requestStatus": "\"unsubmitted\"",
                "status": "\"open\""
              }
            },
            "submitted_fulfillment_order": {
              "name": "submitted_fulfillment_order",
              "description": "Information on the order",
              "type": "object",
              "properties": {
                "id": {
                  "name": "id",
                  "description": "Identifies id",
                  "type": "string",
                  "example": "\"21057401932826316666967110_4005740193290131085320\""
                },
                "request_status": {
                  "name": "request_status",
                  "description": "Request status",
                  "type": "string",
                  "example": "\"submitted\""
                },
                "status": {
                  "name": "status",
                  "description": "Performance-date status",
                  "type": "string",
                  "example": "\"open\""
                }
              },
              "example": {
                "id": "\"21057401932826316666967110_4005740193290131085320\"",
                "request_status": "\"submitted\"",
                "status": "\"open\""
              }
            }
          },
          "example": {
            "fulfillment_order_merchant_request": {
              "message": "\"Fragile\"",
              "notify_customer": true
            },
            "original_fulfillment_order": {
              "id": "\"21057401932826316666967110_4005740193290131085320\"",
              "requestStatus": "\"unsubmitted\"",
              "status": "\"open\""
            },
            "submitted_fulfillment_order": {
              "id": "\"21057401932826316666967110_4005740193290131085320\"",
              "request_status": "\"submitted\"",
              "status": "\"open\""
            }
          }
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "description": "After receiving a webhook notification from SHOPLINE, you must respond with the following format: \n\n``` HTTP/1.1 200 OK ```\n\nFor more information about how to subscribe to webhooks and webhook response rules, refer to [Webhook overview](https://developer.shopline.com/docs/apps/api-instructions-for-use/webhooks/overview.md)."
    }
  },
  "info": {
    "title": "Submit request for fulfillment",
    "version": "v20270301"
  }
}
```