{ "service": "woocommerce", "displayName": "WooCommerce", "categories": [ "Marketing" ], "authTypes": [ "custom_credential" ], "auth": [ { "type": "custom_credential", "fields": [ { "key": "storeUrl", "label": "Store URL", "inputType": "text", "required": true, "secret": false, "placeholder": "https://example.com", "description": "WooCommerce store URL used as the REST API host. Use the HTTPS URL of the WordPress site where WooCommerce is installed." }, { "key": "consumerKey", "label": "Consumer Key", "inputType": "text", "required": true, "secret": false, "placeholder": "ck_...", "description": "WooCommerce REST API consumer key used as the Basic Auth username. Create keys in WordPress admin under WooCommerce > Settings > Advanced > REST API." }, { "key": "consumerSecret", "label": "Consumer Secret", "inputType": "password", "required": true, "secret": true, "placeholder": "cs_...", "description": "WooCommerce REST API consumer secret used as the Basic Auth password." }, { "key": "wordpressUsername", "label": "WordPress Username", "inputType": "text", "required": false, "secret": false, "placeholder": "admin", "description": "Optional WordPress username used only for media uploads through the WordPress REST API." }, { "key": "wordpressApplicationPassword", "label": "WordPress Application Password", "inputType": "password", "required": false, "secret": true, "placeholder": "xxxx xxxx xxxx xxxx xxxx xxxx", "description": "Optional WordPress application password used only for media uploads through /wp-json/wp/v2/media." } ], "testAction": { "actionName": "list_products", "input": { "perPage": 1 } } } ], "homepageUrl": "https://woocommerce.com", "actions": [ { "id": "woocommerce.add_order_note", "service": "woocommerce", "name": "add_order_note", "description": "Add an administrator or customer-visible note to one WooCommerce order.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "orderId": { "type": "integer", "minimum": 1, "description": "The WooCommerce order ID." }, "note": { "type": "string", "description": "The note body to add to the order." }, "customerNote": { "type": "boolean", "description": "Whether the note should be visible to the customer." } }, "additionalProperties": false, "required": [ "orderId", "note" ], "description": "The input payload for adding a WooCommerce order note." }, "outputSchema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce order note ID." }, { "type": "null" } ] }, "author": { "anyOf": [ { "type": "string", "description": "The note author name." }, { "type": "null" } ] }, "dateCreated": { "anyOf": [ { "type": "string", "description": "The note creation timestamp in the store timezone." }, { "type": "null" } ] }, "note": { "anyOf": [ { "type": "string", "description": "The note body." }, { "type": "null" } ] }, "customerNote": { "type": "boolean", "description": "Whether the note is visible to the customer." } }, "additionalProperties": false, "description": "A normalized WooCommerce order note." } }, { "id": "woocommerce.create_coupon", "service": "woocommerce", "name": "create_coupon", "description": "Create a WooCommerce coupon.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "code": { "type": "string", "description": "The coupon code." }, "discountType": { "type": "string", "description": "The WooCommerce coupon discount type." }, "amount": { "type": "string", "description": "The coupon amount as a decimal string." }, "description": { "type": "string", "description": "The coupon description." }, "individualUse": { "type": "boolean", "description": "Whether the coupon can only be used individually." }, "excludeSaleItems": { "type": "boolean", "description": "Whether sale items should be excluded from the coupon." }, "freeShipping": { "type": "boolean", "description": "Whether the coupon grants free shipping." }, "dateExpires": { "type": "string", "description": "The coupon expiration date in the store timezone." }, "minimumAmount": { "type": "string", "description": "The minimum spend amount required for the coupon." }, "maximumAmount": { "type": "string", "description": "The maximum spend amount allowed for the coupon." } }, "additionalProperties": false, "required": [ "code", "discountType", "amount" ], "description": "The input payload for creating a WooCommerce coupon." }, "outputSchema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce coupon ID." }, { "type": "null" } ] }, "code": { "anyOf": [ { "type": "string", "description": "The coupon code." }, { "type": "null" } ] }, "amount": { "anyOf": [ { "type": "string", "description": "The coupon amount as returned by WooCommerce." }, { "type": "null" } ] }, "discountType": { "anyOf": [ { "type": "string", "description": "The WooCommerce coupon discount type." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "The coupon description." }, { "type": "null" } ] }, "dateCreated": { "anyOf": [ { "type": "string", "description": "The coupon creation timestamp in the store timezone." }, { "type": "null" } ] }, "dateModified": { "anyOf": [ { "type": "string", "description": "The coupon update timestamp in the store timezone." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce coupon." } }, { "id": "woocommerce.create_order", "service": "woocommerce", "name": "create_order", "description": "Create a WooCommerce order with customer, address, line item, and coupon fields.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "pending", "processing", "on-hold", "completed", "cancelled", "refunded", "failed", "trash" ], "description": "The WooCommerce order status." }, "customerId": { "type": "integer", "minimum": 1, "description": "The WooCommerce customer ID for the order." }, "currency": { "type": "string", "description": "The order currency code." }, "billing": { "type": "object", "properties": { "firstName": { "type": "string", "description": "The first name on the address." }, "lastName": { "type": "string", "description": "The last name on the address." }, "company": { "type": "string", "description": "The company name on the address." }, "address1": { "type": "string", "description": "The first address line." }, "address2": { "type": "string", "description": "The second address line." }, "city": { "type": "string", "description": "The city name." }, "state": { "type": "string", "description": "The state, region, or province code." }, "postcode": { "type": "string", "description": "The postal code." }, "country": { "type": "string", "description": "The country code." }, "email": { "type": "string", "description": "The email address on the address." }, "phone": { "type": "string", "description": "The phone number on the address." } }, "additionalProperties": false, "description": "A WooCommerce address payload used in order writes." }, "shipping": { "type": "object", "properties": { "firstName": { "type": "string", "description": "The first name on the address." }, "lastName": { "type": "string", "description": "The last name on the address." }, "company": { "type": "string", "description": "The company name on the address." }, "address1": { "type": "string", "description": "The first address line." }, "address2": { "type": "string", "description": "The second address line." }, "city": { "type": "string", "description": "The city name." }, "state": { "type": "string", "description": "The state, region, or province code." }, "postcode": { "type": "string", "description": "The postal code." }, "country": { "type": "string", "description": "The country code." }, "email": { "type": "string", "description": "The email address on the address." }, "phone": { "type": "string", "description": "The phone number on the address." } }, "additionalProperties": false, "description": "A WooCommerce address payload used in order writes." }, "lineItems": { "type": "array", "items": { "type": "object", "properties": { "productId": { "type": "integer", "minimum": 1, "description": "The WooCommerce product ID." }, "variationId": { "type": "integer", "minimum": 1, "description": "The WooCommerce variation ID." }, "quantity": { "type": "number", "description": "The item quantity." }, "subtotal": { "type": "string", "description": "The line subtotal as a decimal string." }, "total": { "type": "string", "description": "The line total as a decimal string." } }, "additionalProperties": false, "required": [ "productId", "quantity" ], "description": "A WooCommerce order line item payload." }, "description": "The order line items." }, "couponLines": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "description": "The coupon code to apply to the order." } }, "additionalProperties": false, "description": "A WooCommerce coupon line payload." }, "description": "The order coupon lines." }, "shippingLines": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The WooCommerce shipping line ID." }, "methodId": { "type": "string", "description": "The shipping method ID." }, "methodTitle": { "type": "string", "description": "The shipping method display title." }, "total": { "type": "string", "description": "The shipping line total as a decimal string." } }, "additionalProperties": false, "description": "A WooCommerce shipping line payload." }, "description": "The order shipping lines." }, "customerNote": { "type": "string", "description": "A customer-facing note for the order." }, "paymentMethod": { "type": "string", "description": "The payment method identifier." }, "paymentMethodTitle": { "type": "string", "description": "The payment method display title." }, "setPaid": { "type": "boolean", "description": "Whether WooCommerce should mark the order as paid." } }, "additionalProperties": false, "required": [ "lineItems" ], "description": "The input payload for creating a WooCommerce order." }, "outputSchema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce order ID." }, { "type": "null" } ] }, "number": { "anyOf": [ { "type": "string", "description": "The WooCommerce order number." }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string", "description": "The order status." }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string", "description": "The order currency code." }, { "type": "null" } ] }, "total": { "anyOf": [ { "type": "string", "description": "The order total as returned by WooCommerce." }, { "type": "null" } ] }, "customerId": { "anyOf": [ { "type": "integer", "description": "The WooCommerce customer ID associated with the order." }, { "type": "null" } ] }, "dateCreated": { "anyOf": [ { "type": "string", "description": "The order creation timestamp in the store timezone." }, { "type": "null" } ] }, "dateModified": { "anyOf": [ { "type": "string", "description": "The order update timestamp in the store timezone." }, { "type": "null" } ] }, "billing": { "type": "object", "properties": { "firstName": { "anyOf": [ { "type": "string", "description": "The first name on the address." }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "type": "string", "description": "The last name on the address." }, { "type": "null" } ] }, "company": { "anyOf": [ { "type": "string", "description": "The company name on the address." }, { "type": "null" } ] }, "address1": { "anyOf": [ { "type": "string", "description": "The first address line." }, { "type": "null" } ] }, "address2": { "anyOf": [ { "type": "string", "description": "The second address line." }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string", "description": "The city name." }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string", "description": "The state, region, or province code." }, { "type": "null" } ] }, "postcode": { "anyOf": [ { "type": "string", "description": "The postal code." }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string", "description": "The country code." }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string", "description": "The email address on the address, if returned." }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string", "description": "The phone number on the address, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce address payload." }, "shipping": { "type": "object", "properties": { "firstName": { "anyOf": [ { "type": "string", "description": "The first name on the address." }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "type": "string", "description": "The last name on the address." }, { "type": "null" } ] }, "company": { "anyOf": [ { "type": "string", "description": "The company name on the address." }, { "type": "null" } ] }, "address1": { "anyOf": [ { "type": "string", "description": "The first address line." }, { "type": "null" } ] }, "address2": { "anyOf": [ { "type": "string", "description": "The second address line." }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string", "description": "The city name." }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string", "description": "The state, region, or province code." }, { "type": "null" } ] }, "postcode": { "anyOf": [ { "type": "string", "description": "The postal code." }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string", "description": "The country code." }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string", "description": "The email address on the address, if returned." }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string", "description": "The phone number on the address, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce address payload." }, "lineItems": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce line item ID." }, { "type": "null" } ] }, "productId": { "anyOf": [ { "type": "integer", "description": "The related WooCommerce product ID." }, { "type": "null" } ] }, "variationId": { "anyOf": [ { "type": "integer", "description": "The related WooCommerce variation ID." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The line item name." }, { "type": "null" } ] }, "quantity": { "anyOf": [ { "type": "number", "description": "The ordered quantity." }, { "type": "null" } ] }, "total": { "anyOf": [ { "type": "string", "description": "The line item total as returned by WooCommerce." }, { "type": "null" } ] }, "sku": { "anyOf": [ { "type": "string", "description": "The line item SKU, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce order line item." }, "description": "The order line items returned by WooCommerce." } }, "additionalProperties": false, "description": "A normalized WooCommerce order." } }, { "id": "woocommerce.create_product", "service": "woocommerce", "name": "create_product", "description": "Create a WooCommerce product with catalog, price, stock, image, and attribute fields.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "name": { "type": "string", "description": "The product name." }, "type": { "type": "string", "description": "The WooCommerce product type, such as simple or variable." }, "status": { "type": "string", "enum": [ "any", "draft", "pending", "private", "publish" ], "description": "The WooCommerce product status." }, "sku": { "type": "string", "description": "The product SKU." }, "regularPrice": { "type": "string", "description": "The regular product price as a decimal string." }, "salePrice": { "type": "string", "description": "The sale product price as a decimal string." }, "description": { "type": "string", "description": "The full product description." }, "shortDescription": { "type": "string", "description": "The short product description." }, "manageStock": { "type": "boolean", "description": "Whether WooCommerce should manage stock for this product." }, "stockQuantity": { "type": "integer", "description": "The product stock quantity." }, "stockStatus": { "type": "string", "enum": [ "instock", "outofstock", "onbackorder" ], "description": "The WooCommerce stock status." }, "categories": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The WooCommerce term ID." } }, "additionalProperties": false, "description": "A WooCommerce taxonomy term reference used in write payloads." }, "description": "The product category references." }, "tags": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The WooCommerce term ID." } }, "additionalProperties": false, "description": "A WooCommerce taxonomy term reference used in write payloads." }, "description": "The product tag references." }, "images": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The existing WordPress media attachment ID." }, "src": { "type": "string", "description": "A public image URL WooCommerce can import." }, "name": { "type": "string", "description": "The image display name." }, "alt": { "type": "string", "description": "The image alt text." } }, "additionalProperties": false, "description": "A WooCommerce product image reference used in write payloads." }, "description": "The product image references." }, "attributes": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The existing WooCommerce attribute ID." }, "name": { "type": "string", "description": "The custom attribute name when no attribute ID is used." }, "position": { "type": "integer", "description": "The attribute display position." }, "visible": { "type": "boolean", "description": "Whether the attribute is visible on the product page." }, "variation": { "type": "boolean", "description": "Whether the attribute is used for variations." }, "options": { "type": "array", "items": { "type": "string", "description": "One attribute option." }, "description": "The attribute option labels." } }, "additionalProperties": false, "description": "A WooCommerce product attribute payload used in product writes." }, "description": "The product attributes." } }, "additionalProperties": false, "required": [ "name" ], "description": "The input payload for creating a WooCommerce product." }, "outputSchema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce product ID." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The product name." }, { "type": "null" } ] }, "slug": { "anyOf": [ { "type": "string", "description": "The product URL slug." }, { "type": "null" } ] }, "permalink": { "anyOf": [ { "type": "string", "description": "The product permalink." }, { "type": "null" } ] }, "type": { "anyOf": [ { "type": "string", "description": "The WooCommerce product type." }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string", "description": "The product status." }, { "type": "null" } ] }, "sku": { "anyOf": [ { "type": "string", "description": "The product SKU." }, { "type": "null" } ] }, "price": { "anyOf": [ { "type": "string", "description": "The current product price as returned by WooCommerce." }, { "type": "null" } ] }, "regularPrice": { "anyOf": [ { "type": "string", "description": "The regular product price as returned by WooCommerce." }, { "type": "null" } ] }, "salePrice": { "anyOf": [ { "type": "string", "description": "The sale product price as returned by WooCommerce." }, { "type": "null" } ] }, "stockStatus": { "anyOf": [ { "type": "string", "description": "The product stock status." }, { "type": "null" } ] }, "stockQuantity": { "anyOf": [ { "type": "integer", "description": "The product stock quantity, if tracked." }, { "type": "null" } ] }, "categories": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce category ID." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The category display name." }, { "type": "null" } ] }, "slug": { "anyOf": [ { "type": "string", "description": "The category URL slug." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "One WooCommerce product category attached to a product." }, "description": "The product categories returned by WooCommerce." }, "images": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce image attachment ID." }, { "type": "null" } ] }, "src": { "anyOf": [ { "type": "string", "description": "The image URL." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The image display name." }, { "type": "null" } ] }, "alt": { "anyOf": [ { "type": "string", "description": "The image alt text." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "One WooCommerce product image." }, "description": "The product images returned by WooCommerce." } }, "additionalProperties": false, "description": "A normalized WooCommerce product." } }, { "id": "woocommerce.create_product_variation", "service": "woocommerce", "name": "create_product_variation", "description": "Create a variation for one WooCommerce variable product.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "productId": { "type": "integer", "minimum": 1, "description": "The WooCommerce product ID." }, "sku": { "type": "string", "description": "The variation SKU." }, "regularPrice": { "type": "string", "description": "The regular variation price as a decimal string." }, "salePrice": { "type": "string", "description": "The sale variation price as a decimal string." }, "manageStock": { "type": "boolean", "description": "Whether WooCommerce should manage stock for this variation." }, "stockQuantity": { "type": "integer", "description": "The variation stock quantity." }, "stockStatus": { "type": "string", "enum": [ "instock", "outofstock", "onbackorder" ], "description": "The WooCommerce stock status." }, "attributes": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The existing WooCommerce attribute ID." }, "name": { "type": "string", "description": "The custom attribute name when no attribute ID is used." }, "option": { "type": "string", "description": "The selected attribute option." } }, "additionalProperties": false, "required": [ "option" ], "description": "A WooCommerce variation attribute payload." }, "description": "The variation attributes." }, "image": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The existing WordPress media attachment ID." }, "src": { "type": "string", "description": "A public image URL WooCommerce can import." }, "name": { "type": "string", "description": "The image display name." }, "alt": { "type": "string", "description": "The image alt text." } }, "additionalProperties": false, "description": "A WooCommerce product image reference used in write payloads." } }, "additionalProperties": false, "required": [ "productId" ], "description": "The input payload for creating a WooCommerce product variation." }, "outputSchema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce variation ID." }, { "type": "null" } ] }, "sku": { "anyOf": [ { "type": "string", "description": "The variation SKU." }, { "type": "null" } ] }, "price": { "anyOf": [ { "type": "string", "description": "The current variation price as returned by WooCommerce." }, { "type": "null" } ] }, "regularPrice": { "anyOf": [ { "type": "string", "description": "The regular variation price as returned by WooCommerce." }, { "type": "null" } ] }, "salePrice": { "anyOf": [ { "type": "string", "description": "The sale variation price as returned by WooCommerce." }, { "type": "null" } ] }, "stockStatus": { "anyOf": [ { "type": "string", "description": "The variation stock status." }, { "type": "null" } ] }, "stockQuantity": { "anyOf": [ { "type": "integer", "description": "The variation stock quantity, if tracked." }, { "type": "null" } ] }, "attributes": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce attribute ID." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The attribute display name." }, { "type": "null" } ] }, "option": { "anyOf": [ { "type": "string", "description": "The selected attribute option." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce variation attribute." }, "description": "The variation attributes returned by WooCommerce." }, "image": { "anyOf": [ { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce image attachment ID." }, { "type": "null" } ] }, "src": { "anyOf": [ { "type": "string", "description": "The image URL." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The image display name." }, { "type": "null" } ] }, "alt": { "anyOf": [ { "type": "string", "description": "The image alt text." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "One WooCommerce product image." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce product variation." } }, { "id": "woocommerce.get_coupon", "service": "woocommerce", "name": "get_coupon", "description": "Fetch one WooCommerce coupon by coupon ID.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "couponId": { "type": "integer", "minimum": 1, "description": "The WooCommerce couponId to fetch." } }, "additionalProperties": false, "required": [ "couponId" ], "description": "The input payload for couponId." }, "outputSchema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce coupon ID." }, { "type": "null" } ] }, "code": { "anyOf": [ { "type": "string", "description": "The coupon code." }, { "type": "null" } ] }, "amount": { "anyOf": [ { "type": "string", "description": "The coupon amount as returned by WooCommerce." }, { "type": "null" } ] }, "discountType": { "anyOf": [ { "type": "string", "description": "The WooCommerce coupon discount type." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "The coupon description." }, { "type": "null" } ] }, "dateCreated": { "anyOf": [ { "type": "string", "description": "The coupon creation timestamp in the store timezone." }, { "type": "null" } ] }, "dateModified": { "anyOf": [ { "type": "string", "description": "The coupon update timestamp in the store timezone." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce coupon." } }, { "id": "woocommerce.get_customer", "service": "woocommerce", "name": "get_customer", "description": "Fetch one WooCommerce customer by customer ID.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "customerId": { "type": "integer", "minimum": 1, "description": "The WooCommerce customerId to fetch." } }, "additionalProperties": false, "required": [ "customerId" ], "description": "The input payload for customerId." }, "outputSchema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce customer ID." }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string", "description": "The customer email address." }, { "type": "null" } ] }, "firstName": { "anyOf": [ { "type": "string", "description": "The customer first name." }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "type": "string", "description": "The customer last name." }, { "type": "null" } ] }, "username": { "anyOf": [ { "type": "string", "description": "The customer username." }, { "type": "null" } ] }, "role": { "anyOf": [ { "type": "string", "description": "The customer role." }, { "type": "null" } ] }, "dateCreated": { "anyOf": [ { "type": "string", "description": "The customer creation timestamp in the store timezone." }, { "type": "null" } ] }, "dateModified": { "anyOf": [ { "type": "string", "description": "The customer update timestamp in the store timezone." }, { "type": "null" } ] }, "billing": { "type": "object", "properties": { "firstName": { "anyOf": [ { "type": "string", "description": "The first name on the address." }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "type": "string", "description": "The last name on the address." }, { "type": "null" } ] }, "company": { "anyOf": [ { "type": "string", "description": "The company name on the address." }, { "type": "null" } ] }, "address1": { "anyOf": [ { "type": "string", "description": "The first address line." }, { "type": "null" } ] }, "address2": { "anyOf": [ { "type": "string", "description": "The second address line." }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string", "description": "The city name." }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string", "description": "The state, region, or province code." }, { "type": "null" } ] }, "postcode": { "anyOf": [ { "type": "string", "description": "The postal code." }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string", "description": "The country code." }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string", "description": "The email address on the address, if returned." }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string", "description": "The phone number on the address, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce address payload." }, "shipping": { "type": "object", "properties": { "firstName": { "anyOf": [ { "type": "string", "description": "The first name on the address." }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "type": "string", "description": "The last name on the address." }, { "type": "null" } ] }, "company": { "anyOf": [ { "type": "string", "description": "The company name on the address." }, { "type": "null" } ] }, "address1": { "anyOf": [ { "type": "string", "description": "The first address line." }, { "type": "null" } ] }, "address2": { "anyOf": [ { "type": "string", "description": "The second address line." }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string", "description": "The city name." }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string", "description": "The state, region, or province code." }, { "type": "null" } ] }, "postcode": { "anyOf": [ { "type": "string", "description": "The postal code." }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string", "description": "The country code." }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string", "description": "The email address on the address, if returned." }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string", "description": "The phone number on the address, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce address payload." } }, "additionalProperties": false, "description": "A normalized WooCommerce customer." } }, { "id": "woocommerce.get_order", "service": "woocommerce", "name": "get_order", "description": "Fetch one WooCommerce order by order ID.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "orderId": { "type": "integer", "minimum": 1, "description": "The WooCommerce orderId to fetch." } }, "additionalProperties": false, "required": [ "orderId" ], "description": "The input payload for orderId." }, "outputSchema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce order ID." }, { "type": "null" } ] }, "number": { "anyOf": [ { "type": "string", "description": "The WooCommerce order number." }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string", "description": "The order status." }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string", "description": "The order currency code." }, { "type": "null" } ] }, "total": { "anyOf": [ { "type": "string", "description": "The order total as returned by WooCommerce." }, { "type": "null" } ] }, "customerId": { "anyOf": [ { "type": "integer", "description": "The WooCommerce customer ID associated with the order." }, { "type": "null" } ] }, "dateCreated": { "anyOf": [ { "type": "string", "description": "The order creation timestamp in the store timezone." }, { "type": "null" } ] }, "dateModified": { "anyOf": [ { "type": "string", "description": "The order update timestamp in the store timezone." }, { "type": "null" } ] }, "billing": { "type": "object", "properties": { "firstName": { "anyOf": [ { "type": "string", "description": "The first name on the address." }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "type": "string", "description": "The last name on the address." }, { "type": "null" } ] }, "company": { "anyOf": [ { "type": "string", "description": "The company name on the address." }, { "type": "null" } ] }, "address1": { "anyOf": [ { "type": "string", "description": "The first address line." }, { "type": "null" } ] }, "address2": { "anyOf": [ { "type": "string", "description": "The second address line." }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string", "description": "The city name." }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string", "description": "The state, region, or province code." }, { "type": "null" } ] }, "postcode": { "anyOf": [ { "type": "string", "description": "The postal code." }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string", "description": "The country code." }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string", "description": "The email address on the address, if returned." }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string", "description": "The phone number on the address, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce address payload." }, "shipping": { "type": "object", "properties": { "firstName": { "anyOf": [ { "type": "string", "description": "The first name on the address." }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "type": "string", "description": "The last name on the address." }, { "type": "null" } ] }, "company": { "anyOf": [ { "type": "string", "description": "The company name on the address." }, { "type": "null" } ] }, "address1": { "anyOf": [ { "type": "string", "description": "The first address line." }, { "type": "null" } ] }, "address2": { "anyOf": [ { "type": "string", "description": "The second address line." }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string", "description": "The city name." }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string", "description": "The state, region, or province code." }, { "type": "null" } ] }, "postcode": { "anyOf": [ { "type": "string", "description": "The postal code." }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string", "description": "The country code." }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string", "description": "The email address on the address, if returned." }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string", "description": "The phone number on the address, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce address payload." }, "lineItems": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce line item ID." }, { "type": "null" } ] }, "productId": { "anyOf": [ { "type": "integer", "description": "The related WooCommerce product ID." }, { "type": "null" } ] }, "variationId": { "anyOf": [ { "type": "integer", "description": "The related WooCommerce variation ID." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The line item name." }, { "type": "null" } ] }, "quantity": { "anyOf": [ { "type": "number", "description": "The ordered quantity." }, { "type": "null" } ] }, "total": { "anyOf": [ { "type": "string", "description": "The line item total as returned by WooCommerce." }, { "type": "null" } ] }, "sku": { "anyOf": [ { "type": "string", "description": "The line item SKU, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce order line item." }, "description": "The order line items returned by WooCommerce." } }, "additionalProperties": false, "description": "A normalized WooCommerce order." } }, { "id": "woocommerce.get_product", "service": "woocommerce", "name": "get_product", "description": "Fetch one WooCommerce product by product ID.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "productId": { "type": "integer", "minimum": 1, "description": "The WooCommerce productId to fetch." } }, "additionalProperties": false, "required": [ "productId" ], "description": "The input payload for productId." }, "outputSchema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce product ID." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The product name." }, { "type": "null" } ] }, "slug": { "anyOf": [ { "type": "string", "description": "The product URL slug." }, { "type": "null" } ] }, "permalink": { "anyOf": [ { "type": "string", "description": "The product permalink." }, { "type": "null" } ] }, "type": { "anyOf": [ { "type": "string", "description": "The WooCommerce product type." }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string", "description": "The product status." }, { "type": "null" } ] }, "sku": { "anyOf": [ { "type": "string", "description": "The product SKU." }, { "type": "null" } ] }, "price": { "anyOf": [ { "type": "string", "description": "The current product price as returned by WooCommerce." }, { "type": "null" } ] }, "regularPrice": { "anyOf": [ { "type": "string", "description": "The regular product price as returned by WooCommerce." }, { "type": "null" } ] }, "salePrice": { "anyOf": [ { "type": "string", "description": "The sale product price as returned by WooCommerce." }, { "type": "null" } ] }, "stockStatus": { "anyOf": [ { "type": "string", "description": "The product stock status." }, { "type": "null" } ] }, "stockQuantity": { "anyOf": [ { "type": "integer", "description": "The product stock quantity, if tracked." }, { "type": "null" } ] }, "categories": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce category ID." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The category display name." }, { "type": "null" } ] }, "slug": { "anyOf": [ { "type": "string", "description": "The category URL slug." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "One WooCommerce product category attached to a product." }, "description": "The product categories returned by WooCommerce." }, "images": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce image attachment ID." }, { "type": "null" } ] }, "src": { "anyOf": [ { "type": "string", "description": "The image URL." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The image display name." }, { "type": "null" } ] }, "alt": { "anyOf": [ { "type": "string", "description": "The image alt text." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "One WooCommerce product image." }, "description": "The product images returned by WooCommerce." } }, "additionalProperties": false, "description": "A normalized WooCommerce product." } }, { "id": "woocommerce.get_product_variation", "service": "woocommerce", "name": "get_product_variation", "description": "Fetch one WooCommerce product variation by product and variation ID.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "productId": { "type": "integer", "minimum": 1, "description": "The WooCommerce product ID." }, "variationId": { "type": "integer", "minimum": 1, "description": "The WooCommerce variation ID." } }, "additionalProperties": false, "required": [ "productId", "variationId" ], "description": "The input payload for fetching one WooCommerce product variation." }, "outputSchema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce variation ID." }, { "type": "null" } ] }, "sku": { "anyOf": [ { "type": "string", "description": "The variation SKU." }, { "type": "null" } ] }, "price": { "anyOf": [ { "type": "string", "description": "The current variation price as returned by WooCommerce." }, { "type": "null" } ] }, "regularPrice": { "anyOf": [ { "type": "string", "description": "The regular variation price as returned by WooCommerce." }, { "type": "null" } ] }, "salePrice": { "anyOf": [ { "type": "string", "description": "The sale variation price as returned by WooCommerce." }, { "type": "null" } ] }, "stockStatus": { "anyOf": [ { "type": "string", "description": "The variation stock status." }, { "type": "null" } ] }, "stockQuantity": { "anyOf": [ { "type": "integer", "description": "The variation stock quantity, if tracked." }, { "type": "null" } ] }, "attributes": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce attribute ID." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The attribute display name." }, { "type": "null" } ] }, "option": { "anyOf": [ { "type": "string", "description": "The selected attribute option." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce variation attribute." }, "description": "The variation attributes returned by WooCommerce." }, "image": { "anyOf": [ { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce image attachment ID." }, { "type": "null" } ] }, "src": { "anyOf": [ { "type": "string", "description": "The image URL." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The image display name." }, { "type": "null" } ] }, "alt": { "anyOf": [ { "type": "string", "description": "The image alt text." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "One WooCommerce product image." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce product variation." } }, { "id": "woocommerce.list_coupons", "service": "woocommerce", "name": "list_coupons", "description": "List WooCommerce coupons with common code search and pagination metadata.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "page": { "type": "integer", "minimum": 1, "description": "The page number to retrieve from WooCommerce." }, "perPage": { "type": "integer", "minimum": 1, "maximum": 100, "description": "The maximum number of records to return in one page." }, "search": { "type": "string", "description": "Limit results to coupons matching this search term." }, "code": { "type": "string", "description": "Limit results to coupons with this exact code." }, "order": { "type": "string", "enum": [ "asc", "desc" ], "description": "The result sort direction." }, "orderBy": { "type": "string", "description": "Sort by an official WooCommerce orderby value." } }, "additionalProperties": false, "description": "The input payload for listing WooCommerce records." }, "outputSchema": { "type": "object", "properties": { "coupons": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce coupon ID." }, { "type": "null" } ] }, "code": { "anyOf": [ { "type": "string", "description": "The coupon code." }, { "type": "null" } ] }, "amount": { "anyOf": [ { "type": "string", "description": "The coupon amount as returned by WooCommerce." }, { "type": "null" } ] }, "discountType": { "anyOf": [ { "type": "string", "description": "The WooCommerce coupon discount type." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "The coupon description." }, { "type": "null" } ] }, "dateCreated": { "anyOf": [ { "type": "string", "description": "The coupon creation timestamp in the store timezone." }, { "type": "null" } ] }, "dateModified": { "anyOf": [ { "type": "string", "description": "The coupon update timestamp in the store timezone." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce coupon." }, "description": "The coupons returned by WooCommerce." }, "total": { "anyOf": [ { "type": "integer", "description": "The total number of matching records reported by WooCommerce." }, { "type": "null" } ] }, "totalPages": { "anyOf": [ { "type": "integer", "description": "The total number of result pages reported by WooCommerce." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "coupons", "total", "totalPages" ], "description": "The output payload for listing WooCommerce records." } }, { "id": "woocommerce.list_customers", "service": "woocommerce", "name": "list_customers", "description": "List WooCommerce customers with common filters and pagination metadata.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "page": { "type": "integer", "minimum": 1, "description": "The page number to retrieve from WooCommerce." }, "perPage": { "type": "integer", "minimum": 1, "maximum": 100, "description": "The maximum number of records to return in one page." }, "search": { "type": "string", "description": "Limit results to customers matching this search term." }, "email": { "type": "string", "description": "Limit results to customers with this email address." }, "role": { "type": "string", "description": "Limit results to customers with this WordPress role." }, "order": { "type": "string", "enum": [ "asc", "desc" ], "description": "The result sort direction." }, "orderBy": { "type": "string", "description": "Sort by an official WooCommerce orderby value." } }, "additionalProperties": false, "description": "The input payload for listing WooCommerce records." }, "outputSchema": { "type": "object", "properties": { "customers": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce customer ID." }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string", "description": "The customer email address." }, { "type": "null" } ] }, "firstName": { "anyOf": [ { "type": "string", "description": "The customer first name." }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "type": "string", "description": "The customer last name." }, { "type": "null" } ] }, "username": { "anyOf": [ { "type": "string", "description": "The customer username." }, { "type": "null" } ] }, "role": { "anyOf": [ { "type": "string", "description": "The customer role." }, { "type": "null" } ] }, "dateCreated": { "anyOf": [ { "type": "string", "description": "The customer creation timestamp in the store timezone." }, { "type": "null" } ] }, "dateModified": { "anyOf": [ { "type": "string", "description": "The customer update timestamp in the store timezone." }, { "type": "null" } ] }, "billing": { "type": "object", "properties": { "firstName": { "anyOf": [ { "type": "string", "description": "The first name on the address." }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "type": "string", "description": "The last name on the address." }, { "type": "null" } ] }, "company": { "anyOf": [ { "type": "string", "description": "The company name on the address." }, { "type": "null" } ] }, "address1": { "anyOf": [ { "type": "string", "description": "The first address line." }, { "type": "null" } ] }, "address2": { "anyOf": [ { "type": "string", "description": "The second address line." }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string", "description": "The city name." }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string", "description": "The state, region, or province code." }, { "type": "null" } ] }, "postcode": { "anyOf": [ { "type": "string", "description": "The postal code." }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string", "description": "The country code." }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string", "description": "The email address on the address, if returned." }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string", "description": "The phone number on the address, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce address payload." }, "shipping": { "type": "object", "properties": { "firstName": { "anyOf": [ { "type": "string", "description": "The first name on the address." }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "type": "string", "description": "The last name on the address." }, { "type": "null" } ] }, "company": { "anyOf": [ { "type": "string", "description": "The company name on the address." }, { "type": "null" } ] }, "address1": { "anyOf": [ { "type": "string", "description": "The first address line." }, { "type": "null" } ] }, "address2": { "anyOf": [ { "type": "string", "description": "The second address line." }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string", "description": "The city name." }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string", "description": "The state, region, or province code." }, { "type": "null" } ] }, "postcode": { "anyOf": [ { "type": "string", "description": "The postal code." }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string", "description": "The country code." }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string", "description": "The email address on the address, if returned." }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string", "description": "The phone number on the address, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce address payload." } }, "additionalProperties": false, "description": "A normalized WooCommerce customer." }, "description": "The customers returned by WooCommerce." }, "total": { "anyOf": [ { "type": "integer", "description": "The total number of matching records reported by WooCommerce." }, { "type": "null" } ] }, "totalPages": { "anyOf": [ { "type": "integer", "description": "The total number of result pages reported by WooCommerce." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "customers", "total", "totalPages" ], "description": "The output payload for listing WooCommerce records." } }, { "id": "woocommerce.list_order_notes", "service": "woocommerce", "name": "list_order_notes", "description": "List notes for one WooCommerce order.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "orderId": { "type": "integer", "minimum": 1, "description": "The WooCommerce orderId to fetch." } }, "additionalProperties": false, "required": [ "orderId" ], "description": "The input payload for orderId." }, "outputSchema": { "type": "object", "properties": { "notes": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce order note ID." }, { "type": "null" } ] }, "author": { "anyOf": [ { "type": "string", "description": "The note author name." }, { "type": "null" } ] }, "dateCreated": { "anyOf": [ { "type": "string", "description": "The note creation timestamp in the store timezone." }, { "type": "null" } ] }, "note": { "anyOf": [ { "type": "string", "description": "The note body." }, { "type": "null" } ] }, "customerNote": { "type": "boolean", "description": "Whether the note is visible to the customer." } }, "additionalProperties": false, "description": "A normalized WooCommerce order note." }, "description": "The order notes returned by WooCommerce." } }, "additionalProperties": false, "required": [ "notes" ], "description": "The output payload for listing WooCommerce order notes." } }, { "id": "woocommerce.list_orders", "service": "woocommerce", "name": "list_orders", "description": "List WooCommerce orders with common status, customer, and date filters.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "page": { "type": "integer", "minimum": 1, "description": "The page number to retrieve from WooCommerce." }, "perPage": { "type": "integer", "minimum": 1, "maximum": 100, "description": "The maximum number of records to return in one page." }, "status": { "type": "string", "enum": [ "pending", "processing", "on-hold", "completed", "cancelled", "refunded", "failed", "trash" ], "description": "The WooCommerce order status." }, "customer": { "type": "integer", "minimum": 1, "description": "Limit results to orders for this WooCommerce customer ID." }, "product": { "type": "integer", "minimum": 1, "description": "Limit results to orders containing this product ID." }, "search": { "type": "string", "description": "Limit results to orders matching this search term." }, "after": { "type": "string", "description": "Limit results to orders created after this ISO 8601 timestamp." }, "before": { "type": "string", "description": "Limit results to orders created before this ISO 8601 timestamp." }, "order": { "type": "string", "enum": [ "asc", "desc" ], "description": "The result sort direction." }, "orderBy": { "type": "string", "description": "Sort by an official WooCommerce orderby value." } }, "additionalProperties": false, "description": "The input payload for listing WooCommerce records." }, "outputSchema": { "type": "object", "properties": { "orders": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce order ID." }, { "type": "null" } ] }, "number": { "anyOf": [ { "type": "string", "description": "The WooCommerce order number." }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string", "description": "The order status." }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string", "description": "The order currency code." }, { "type": "null" } ] }, "total": { "anyOf": [ { "type": "string", "description": "The order total as returned by WooCommerce." }, { "type": "null" } ] }, "customerId": { "anyOf": [ { "type": "integer", "description": "The WooCommerce customer ID associated with the order." }, { "type": "null" } ] }, "dateCreated": { "anyOf": [ { "type": "string", "description": "The order creation timestamp in the store timezone." }, { "type": "null" } ] }, "dateModified": { "anyOf": [ { "type": "string", "description": "The order update timestamp in the store timezone." }, { "type": "null" } ] }, "billing": { "type": "object", "properties": { "firstName": { "anyOf": [ { "type": "string", "description": "The first name on the address." }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "type": "string", "description": "The last name on the address." }, { "type": "null" } ] }, "company": { "anyOf": [ { "type": "string", "description": "The company name on the address." }, { "type": "null" } ] }, "address1": { "anyOf": [ { "type": "string", "description": "The first address line." }, { "type": "null" } ] }, "address2": { "anyOf": [ { "type": "string", "description": "The second address line." }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string", "description": "The city name." }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string", "description": "The state, region, or province code." }, { "type": "null" } ] }, "postcode": { "anyOf": [ { "type": "string", "description": "The postal code." }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string", "description": "The country code." }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string", "description": "The email address on the address, if returned." }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string", "description": "The phone number on the address, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce address payload." }, "shipping": { "type": "object", "properties": { "firstName": { "anyOf": [ { "type": "string", "description": "The first name on the address." }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "type": "string", "description": "The last name on the address." }, { "type": "null" } ] }, "company": { "anyOf": [ { "type": "string", "description": "The company name on the address." }, { "type": "null" } ] }, "address1": { "anyOf": [ { "type": "string", "description": "The first address line." }, { "type": "null" } ] }, "address2": { "anyOf": [ { "type": "string", "description": "The second address line." }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string", "description": "The city name." }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string", "description": "The state, region, or province code." }, { "type": "null" } ] }, "postcode": { "anyOf": [ { "type": "string", "description": "The postal code." }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string", "description": "The country code." }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string", "description": "The email address on the address, if returned." }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string", "description": "The phone number on the address, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce address payload." }, "lineItems": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce line item ID." }, { "type": "null" } ] }, "productId": { "anyOf": [ { "type": "integer", "description": "The related WooCommerce product ID." }, { "type": "null" } ] }, "variationId": { "anyOf": [ { "type": "integer", "description": "The related WooCommerce variation ID." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The line item name." }, { "type": "null" } ] }, "quantity": { "anyOf": [ { "type": "number", "description": "The ordered quantity." }, { "type": "null" } ] }, "total": { "anyOf": [ { "type": "string", "description": "The line item total as returned by WooCommerce." }, { "type": "null" } ] }, "sku": { "anyOf": [ { "type": "string", "description": "The line item SKU, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce order line item." }, "description": "The order line items returned by WooCommerce." } }, "additionalProperties": false, "description": "A normalized WooCommerce order." }, "description": "The orders returned by WooCommerce." }, "total": { "anyOf": [ { "type": "integer", "description": "The total number of matching records reported by WooCommerce." }, { "type": "null" } ] }, "totalPages": { "anyOf": [ { "type": "integer", "description": "The total number of result pages reported by WooCommerce." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "orders", "total", "totalPages" ], "description": "The output payload for listing WooCommerce records." } }, { "id": "woocommerce.list_product_attribute_terms", "service": "woocommerce", "name": "list_product_attribute_terms", "description": "List terms for one WooCommerce product attribute.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "attributeId": { "type": "integer", "minimum": 1, "description": "The WooCommerce product attribute ID." }, "page": { "type": "integer", "minimum": 1, "description": "The page number to retrieve from WooCommerce." }, "perPage": { "type": "integer", "minimum": 1, "maximum": 100, "description": "The maximum number of records to return in one page." }, "search": { "type": "string", "description": "Limit results to attribute terms matching this search term." } }, "additionalProperties": false, "required": [ "attributeId" ], "description": "The input payload for listing WooCommerce product attribute terms." }, "outputSchema": { "type": "object", "properties": { "terms": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce term ID." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The term display name." }, { "type": "null" } ] }, "slug": { "anyOf": [ { "type": "string", "description": "The term URL slug." }, { "type": "null" } ] }, "count": { "anyOf": [ { "type": "integer", "description": "The number of products assigned to the term, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce taxonomy term." }, "description": "The attribute terms returned by WooCommerce." }, "total": { "anyOf": [ { "type": "integer", "description": "The total number of matching records reported by WooCommerce." }, { "type": "null" } ] }, "totalPages": { "anyOf": [ { "type": "integer", "description": "The total number of result pages reported by WooCommerce." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "terms", "total", "totalPages" ], "description": "The output payload for listing WooCommerce attribute terms." } }, { "id": "woocommerce.list_product_attributes", "service": "woocommerce", "name": "list_product_attributes", "description": "List WooCommerce product attributes.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": {}, "additionalProperties": false, "description": "The input payload for listing WooCommerce product attributes." }, "outputSchema": { "type": "object", "properties": { "attributes": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce attribute ID." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The attribute display name." }, { "type": "null" } ] }, "slug": { "anyOf": [ { "type": "string", "description": "The attribute slug." }, { "type": "null" } ] }, "type": { "anyOf": [ { "type": "string", "description": "The attribute type." }, { "type": "null" } ] }, "orderBy": { "anyOf": [ { "type": "string", "description": "The attribute sort mode." }, { "type": "null" } ] }, "hasArchives": { "anyOf": [ { "type": "boolean", "description": "Whether the attribute has archives enabled." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce product attribute." }, "description": "The attributes returned by WooCommerce." } }, "additionalProperties": false, "required": [ "attributes" ], "description": "The output payload for listing WooCommerce product attributes." } }, { "id": "woocommerce.list_product_categories", "service": "woocommerce", "name": "list_product_categories", "description": "List WooCommerce product categories with filters and pagination metadata.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "page": { "type": "integer", "minimum": 1, "description": "The page number to retrieve from WooCommerce." }, "perPage": { "type": "integer", "minimum": 1, "maximum": 100, "description": "The maximum number of records to return in one page." }, "search": { "type": "string", "description": "Limit results to categories matching this search term." }, "order": { "type": "string", "enum": [ "asc", "desc" ], "description": "The result sort direction." }, "orderBy": { "type": "string", "description": "Sort by an official WooCommerce orderby value." } }, "additionalProperties": false, "description": "The input payload for listing WooCommerce records." }, "outputSchema": { "type": "object", "properties": { "categories": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce term ID." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The term display name." }, { "type": "null" } ] }, "slug": { "anyOf": [ { "type": "string", "description": "The term URL slug." }, { "type": "null" } ] }, "count": { "anyOf": [ { "type": "integer", "description": "The number of products assigned to the term, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce taxonomy term." }, "description": "The categories returned by WooCommerce." }, "total": { "anyOf": [ { "type": "integer", "description": "The total number of matching records reported by WooCommerce." }, { "type": "null" } ] }, "totalPages": { "anyOf": [ { "type": "integer", "description": "The total number of result pages reported by WooCommerce." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "categories", "total", "totalPages" ], "description": "The output payload for listing WooCommerce records." } }, { "id": "woocommerce.list_product_tags", "service": "woocommerce", "name": "list_product_tags", "description": "List WooCommerce product tags with filters and pagination metadata.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "page": { "type": "integer", "minimum": 1, "description": "The page number to retrieve from WooCommerce." }, "perPage": { "type": "integer", "minimum": 1, "maximum": 100, "description": "The maximum number of records to return in one page." }, "search": { "type": "string", "description": "Limit results to tags matching this search term." }, "order": { "type": "string", "enum": [ "asc", "desc" ], "description": "The result sort direction." }, "orderBy": { "type": "string", "description": "Sort by an official WooCommerce orderby value." } }, "additionalProperties": false, "description": "The input payload for listing WooCommerce records." }, "outputSchema": { "type": "object", "properties": { "tags": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce term ID." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The term display name." }, { "type": "null" } ] }, "slug": { "anyOf": [ { "type": "string", "description": "The term URL slug." }, { "type": "null" } ] }, "count": { "anyOf": [ { "type": "integer", "description": "The number of products assigned to the term, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce taxonomy term." }, "description": "The tags returned by WooCommerce." }, "total": { "anyOf": [ { "type": "integer", "description": "The total number of matching records reported by WooCommerce." }, { "type": "null" } ] }, "totalPages": { "anyOf": [ { "type": "integer", "description": "The total number of result pages reported by WooCommerce." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "tags", "total", "totalPages" ], "description": "The output payload for listing WooCommerce records." } }, { "id": "woocommerce.list_product_variations", "service": "woocommerce", "name": "list_product_variations", "description": "List variations for one WooCommerce variable product.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "productId": { "type": "integer", "minimum": 1, "description": "The WooCommerce product ID." }, "page": { "type": "integer", "minimum": 1, "description": "The page number to retrieve from WooCommerce." }, "perPage": { "type": "integer", "minimum": 1, "maximum": 100, "description": "The maximum number of records to return in one page." }, "sku": { "type": "string", "description": "Limit results to variations with this SKU." } }, "additionalProperties": false, "required": [ "productId" ], "description": "The input payload for listing WooCommerce product variations." }, "outputSchema": { "type": "object", "properties": { "variations": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce variation ID." }, { "type": "null" } ] }, "sku": { "anyOf": [ { "type": "string", "description": "The variation SKU." }, { "type": "null" } ] }, "price": { "anyOf": [ { "type": "string", "description": "The current variation price as returned by WooCommerce." }, { "type": "null" } ] }, "regularPrice": { "anyOf": [ { "type": "string", "description": "The regular variation price as returned by WooCommerce." }, { "type": "null" } ] }, "salePrice": { "anyOf": [ { "type": "string", "description": "The sale variation price as returned by WooCommerce." }, { "type": "null" } ] }, "stockStatus": { "anyOf": [ { "type": "string", "description": "The variation stock status." }, { "type": "null" } ] }, "stockQuantity": { "anyOf": [ { "type": "integer", "description": "The variation stock quantity, if tracked." }, { "type": "null" } ] }, "attributes": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce attribute ID." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The attribute display name." }, { "type": "null" } ] }, "option": { "anyOf": [ { "type": "string", "description": "The selected attribute option." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce variation attribute." }, "description": "The variation attributes returned by WooCommerce." }, "image": { "anyOf": [ { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce image attachment ID." }, { "type": "null" } ] }, "src": { "anyOf": [ { "type": "string", "description": "The image URL." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The image display name." }, { "type": "null" } ] }, "alt": { "anyOf": [ { "type": "string", "description": "The image alt text." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "One WooCommerce product image." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce product variation." }, "description": "The variations returned by WooCommerce." }, "total": { "anyOf": [ { "type": "integer", "description": "The total number of matching records reported by WooCommerce." }, { "type": "null" } ] }, "totalPages": { "anyOf": [ { "type": "integer", "description": "The total number of result pages reported by WooCommerce." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "variations", "total", "totalPages" ], "description": "The output payload for listing WooCommerce product variations." } }, { "id": "woocommerce.list_products", "service": "woocommerce", "name": "list_products", "description": "List WooCommerce products with common catalog filters and pagination metadata.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "page": { "type": "integer", "minimum": 1, "description": "The page number to retrieve from WooCommerce." }, "perPage": { "type": "integer", "minimum": 1, "maximum": 100, "description": "The maximum number of records to return in one page." }, "search": { "type": "string", "description": "Limit results to products matching this search term." }, "status": { "type": "string", "enum": [ "any", "draft", "pending", "private", "publish" ], "description": "The WooCommerce product status." }, "sku": { "type": "string", "description": "Limit results to products with this SKU." }, "category": { "type": "string", "description": "Limit results to products assigned to this category ID." }, "tag": { "type": "string", "description": "Limit results to products assigned to this tag ID." }, "featured": { "type": "boolean", "description": "Limit results to featured products when true." }, "onSale": { "type": "boolean", "description": "Limit results to products currently on sale when true." }, "order": { "type": "string", "enum": [ "asc", "desc" ], "description": "The result sort direction." }, "orderBy": { "type": "string", "description": "Sort by an official WooCommerce orderby value." } }, "additionalProperties": false, "description": "The input payload for listing WooCommerce records." }, "outputSchema": { "type": "object", "properties": { "products": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce product ID." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The product name." }, { "type": "null" } ] }, "slug": { "anyOf": [ { "type": "string", "description": "The product URL slug." }, { "type": "null" } ] }, "permalink": { "anyOf": [ { "type": "string", "description": "The product permalink." }, { "type": "null" } ] }, "type": { "anyOf": [ { "type": "string", "description": "The WooCommerce product type." }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string", "description": "The product status." }, { "type": "null" } ] }, "sku": { "anyOf": [ { "type": "string", "description": "The product SKU." }, { "type": "null" } ] }, "price": { "anyOf": [ { "type": "string", "description": "The current product price as returned by WooCommerce." }, { "type": "null" } ] }, "regularPrice": { "anyOf": [ { "type": "string", "description": "The regular product price as returned by WooCommerce." }, { "type": "null" } ] }, "salePrice": { "anyOf": [ { "type": "string", "description": "The sale product price as returned by WooCommerce." }, { "type": "null" } ] }, "stockStatus": { "anyOf": [ { "type": "string", "description": "The product stock status." }, { "type": "null" } ] }, "stockQuantity": { "anyOf": [ { "type": "integer", "description": "The product stock quantity, if tracked." }, { "type": "null" } ] }, "categories": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce category ID." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The category display name." }, { "type": "null" } ] }, "slug": { "anyOf": [ { "type": "string", "description": "The category URL slug." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "One WooCommerce product category attached to a product." }, "description": "The product categories returned by WooCommerce." }, "images": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce image attachment ID." }, { "type": "null" } ] }, "src": { "anyOf": [ { "type": "string", "description": "The image URL." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The image display name." }, { "type": "null" } ] }, "alt": { "anyOf": [ { "type": "string", "description": "The image alt text." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "One WooCommerce product image." }, "description": "The product images returned by WooCommerce." } }, "additionalProperties": false, "description": "A normalized WooCommerce product." }, "description": "The products returned by WooCommerce." }, "total": { "anyOf": [ { "type": "integer", "description": "The total number of matching records reported by WooCommerce." }, { "type": "null" } ] }, "totalPages": { "anyOf": [ { "type": "integer", "description": "The total number of result pages reported by WooCommerce." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "products", "total", "totalPages" ], "description": "The output payload for listing WooCommerce records." } }, { "id": "woocommerce.update_coupon", "service": "woocommerce", "name": "update_coupon", "description": "Update a WooCommerce coupon by coupon ID.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "couponId": { "type": "integer", "minimum": 1, "description": "The WooCommerce coupon ID to update." }, "code": { "type": "string", "description": "The coupon code." }, "discountType": { "type": "string", "description": "The WooCommerce coupon discount type." }, "amount": { "type": "string", "description": "The coupon amount as a decimal string." }, "description": { "type": "string", "description": "The coupon description." }, "individualUse": { "type": "boolean", "description": "Whether the coupon can only be used individually." }, "excludeSaleItems": { "type": "boolean", "description": "Whether sale items should be excluded from the coupon." }, "freeShipping": { "type": "boolean", "description": "Whether the coupon grants free shipping." }, "dateExpires": { "type": "string", "description": "The coupon expiration date in the store timezone." }, "minimumAmount": { "type": "string", "description": "The minimum spend amount required for the coupon." }, "maximumAmount": { "type": "string", "description": "The maximum spend amount allowed for the coupon." } }, "additionalProperties": false, "required": [ "couponId" ], "description": "The input payload for updating a WooCommerce coupon." }, "outputSchema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce coupon ID." }, { "type": "null" } ] }, "code": { "anyOf": [ { "type": "string", "description": "The coupon code." }, { "type": "null" } ] }, "amount": { "anyOf": [ { "type": "string", "description": "The coupon amount as returned by WooCommerce." }, { "type": "null" } ] }, "discountType": { "anyOf": [ { "type": "string", "description": "The WooCommerce coupon discount type." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "The coupon description." }, { "type": "null" } ] }, "dateCreated": { "anyOf": [ { "type": "string", "description": "The coupon creation timestamp in the store timezone." }, { "type": "null" } ] }, "dateModified": { "anyOf": [ { "type": "string", "description": "The coupon update timestamp in the store timezone." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce coupon." } }, { "id": "woocommerce.update_order", "service": "woocommerce", "name": "update_order", "description": "Update a WooCommerce order by order ID.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "orderId": { "type": "integer", "minimum": 1, "description": "The WooCommerce order ID to update." }, "status": { "type": "string", "enum": [ "pending", "processing", "on-hold", "completed", "cancelled", "refunded", "failed", "trash" ], "description": "The WooCommerce order status." }, "customerId": { "type": "integer", "minimum": 1, "description": "The WooCommerce customer ID for the order." }, "billing": { "type": "object", "properties": { "firstName": { "type": "string", "description": "The first name on the address." }, "lastName": { "type": "string", "description": "The last name on the address." }, "company": { "type": "string", "description": "The company name on the address." }, "address1": { "type": "string", "description": "The first address line." }, "address2": { "type": "string", "description": "The second address line." }, "city": { "type": "string", "description": "The city name." }, "state": { "type": "string", "description": "The state, region, or province code." }, "postcode": { "type": "string", "description": "The postal code." }, "country": { "type": "string", "description": "The country code." }, "email": { "type": "string", "description": "The email address on the address." }, "phone": { "type": "string", "description": "The phone number on the address." } }, "additionalProperties": false, "description": "A WooCommerce address payload used in order writes." }, "shipping": { "type": "object", "properties": { "firstName": { "type": "string", "description": "The first name on the address." }, "lastName": { "type": "string", "description": "The last name on the address." }, "company": { "type": "string", "description": "The company name on the address." }, "address1": { "type": "string", "description": "The first address line." }, "address2": { "type": "string", "description": "The second address line." }, "city": { "type": "string", "description": "The city name." }, "state": { "type": "string", "description": "The state, region, or province code." }, "postcode": { "type": "string", "description": "The postal code." }, "country": { "type": "string", "description": "The country code." }, "email": { "type": "string", "description": "The email address on the address." }, "phone": { "type": "string", "description": "The phone number on the address." } }, "additionalProperties": false, "description": "A WooCommerce address payload used in order writes." }, "shippingLines": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The WooCommerce shipping line ID." }, "methodId": { "type": "string", "description": "The shipping method ID." }, "methodTitle": { "type": "string", "description": "The shipping method display title." }, "total": { "type": "string", "description": "The shipping line total as a decimal string." } }, "additionalProperties": false, "description": "A WooCommerce shipping line payload." }, "description": "The order shipping lines." }, "customerNote": { "type": "string", "description": "A customer-facing note for the order." }, "paymentMethod": { "type": "string", "description": "The payment method identifier." }, "paymentMethodTitle": { "type": "string", "description": "The payment method display title." }, "setPaid": { "type": "boolean", "description": "Whether WooCommerce should mark the order as paid." } }, "additionalProperties": false, "required": [ "orderId" ], "description": "The input payload for updating a WooCommerce order." }, "outputSchema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce order ID." }, { "type": "null" } ] }, "number": { "anyOf": [ { "type": "string", "description": "The WooCommerce order number." }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string", "description": "The order status." }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string", "description": "The order currency code." }, { "type": "null" } ] }, "total": { "anyOf": [ { "type": "string", "description": "The order total as returned by WooCommerce." }, { "type": "null" } ] }, "customerId": { "anyOf": [ { "type": "integer", "description": "The WooCommerce customer ID associated with the order." }, { "type": "null" } ] }, "dateCreated": { "anyOf": [ { "type": "string", "description": "The order creation timestamp in the store timezone." }, { "type": "null" } ] }, "dateModified": { "anyOf": [ { "type": "string", "description": "The order update timestamp in the store timezone." }, { "type": "null" } ] }, "billing": { "type": "object", "properties": { "firstName": { "anyOf": [ { "type": "string", "description": "The first name on the address." }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "type": "string", "description": "The last name on the address." }, { "type": "null" } ] }, "company": { "anyOf": [ { "type": "string", "description": "The company name on the address." }, { "type": "null" } ] }, "address1": { "anyOf": [ { "type": "string", "description": "The first address line." }, { "type": "null" } ] }, "address2": { "anyOf": [ { "type": "string", "description": "The second address line." }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string", "description": "The city name." }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string", "description": "The state, region, or province code." }, { "type": "null" } ] }, "postcode": { "anyOf": [ { "type": "string", "description": "The postal code." }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string", "description": "The country code." }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string", "description": "The email address on the address, if returned." }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string", "description": "The phone number on the address, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce address payload." }, "shipping": { "type": "object", "properties": { "firstName": { "anyOf": [ { "type": "string", "description": "The first name on the address." }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "type": "string", "description": "The last name on the address." }, { "type": "null" } ] }, "company": { "anyOf": [ { "type": "string", "description": "The company name on the address." }, { "type": "null" } ] }, "address1": { "anyOf": [ { "type": "string", "description": "The first address line." }, { "type": "null" } ] }, "address2": { "anyOf": [ { "type": "string", "description": "The second address line." }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string", "description": "The city name." }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string", "description": "The state, region, or province code." }, { "type": "null" } ] }, "postcode": { "anyOf": [ { "type": "string", "description": "The postal code." }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string", "description": "The country code." }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string", "description": "The email address on the address, if returned." }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string", "description": "The phone number on the address, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce address payload." }, "lineItems": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce line item ID." }, { "type": "null" } ] }, "productId": { "anyOf": [ { "type": "integer", "description": "The related WooCommerce product ID." }, { "type": "null" } ] }, "variationId": { "anyOf": [ { "type": "integer", "description": "The related WooCommerce variation ID." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The line item name." }, { "type": "null" } ] }, "quantity": { "anyOf": [ { "type": "number", "description": "The ordered quantity." }, { "type": "null" } ] }, "total": { "anyOf": [ { "type": "string", "description": "The line item total as returned by WooCommerce." }, { "type": "null" } ] }, "sku": { "anyOf": [ { "type": "string", "description": "The line item SKU, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce order line item." }, "description": "The order line items returned by WooCommerce." } }, "additionalProperties": false, "description": "A normalized WooCommerce order." } }, { "id": "woocommerce.update_order_status", "service": "woocommerce", "name": "update_order_status", "description": "Update the status of one WooCommerce order.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "orderId": { "type": "integer", "minimum": 1, "description": "The WooCommerce order ID to update." }, "status": { "type": "string", "enum": [ "pending", "processing", "on-hold", "completed", "cancelled", "refunded", "failed", "trash" ], "description": "The WooCommerce order status." } }, "additionalProperties": false, "required": [ "orderId", "status" ], "description": "The input payload for updating a WooCommerce order status." }, "outputSchema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce order ID." }, { "type": "null" } ] }, "number": { "anyOf": [ { "type": "string", "description": "The WooCommerce order number." }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string", "description": "The order status." }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string", "description": "The order currency code." }, { "type": "null" } ] }, "total": { "anyOf": [ { "type": "string", "description": "The order total as returned by WooCommerce." }, { "type": "null" } ] }, "customerId": { "anyOf": [ { "type": "integer", "description": "The WooCommerce customer ID associated with the order." }, { "type": "null" } ] }, "dateCreated": { "anyOf": [ { "type": "string", "description": "The order creation timestamp in the store timezone." }, { "type": "null" } ] }, "dateModified": { "anyOf": [ { "type": "string", "description": "The order update timestamp in the store timezone." }, { "type": "null" } ] }, "billing": { "type": "object", "properties": { "firstName": { "anyOf": [ { "type": "string", "description": "The first name on the address." }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "type": "string", "description": "The last name on the address." }, { "type": "null" } ] }, "company": { "anyOf": [ { "type": "string", "description": "The company name on the address." }, { "type": "null" } ] }, "address1": { "anyOf": [ { "type": "string", "description": "The first address line." }, { "type": "null" } ] }, "address2": { "anyOf": [ { "type": "string", "description": "The second address line." }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string", "description": "The city name." }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string", "description": "The state, region, or province code." }, { "type": "null" } ] }, "postcode": { "anyOf": [ { "type": "string", "description": "The postal code." }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string", "description": "The country code." }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string", "description": "The email address on the address, if returned." }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string", "description": "The phone number on the address, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce address payload." }, "shipping": { "type": "object", "properties": { "firstName": { "anyOf": [ { "type": "string", "description": "The first name on the address." }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "type": "string", "description": "The last name on the address." }, { "type": "null" } ] }, "company": { "anyOf": [ { "type": "string", "description": "The company name on the address." }, { "type": "null" } ] }, "address1": { "anyOf": [ { "type": "string", "description": "The first address line." }, { "type": "null" } ] }, "address2": { "anyOf": [ { "type": "string", "description": "The second address line." }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string", "description": "The city name." }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string", "description": "The state, region, or province code." }, { "type": "null" } ] }, "postcode": { "anyOf": [ { "type": "string", "description": "The postal code." }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string", "description": "The country code." }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string", "description": "The email address on the address, if returned." }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string", "description": "The phone number on the address, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce address payload." }, "lineItems": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce line item ID." }, { "type": "null" } ] }, "productId": { "anyOf": [ { "type": "integer", "description": "The related WooCommerce product ID." }, { "type": "null" } ] }, "variationId": { "anyOf": [ { "type": "integer", "description": "The related WooCommerce variation ID." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The line item name." }, { "type": "null" } ] }, "quantity": { "anyOf": [ { "type": "number", "description": "The ordered quantity." }, { "type": "null" } ] }, "total": { "anyOf": [ { "type": "string", "description": "The line item total as returned by WooCommerce." }, { "type": "null" } ] }, "sku": { "anyOf": [ { "type": "string", "description": "The line item SKU, if returned." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce order line item." }, "description": "The order line items returned by WooCommerce." } }, "additionalProperties": false, "description": "A normalized WooCommerce order." } }, { "id": "woocommerce.update_product", "service": "woocommerce", "name": "update_product", "description": "Update a WooCommerce product by product ID.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "productId": { "type": "integer", "minimum": 1, "description": "The WooCommerce product ID to update." }, "name": { "type": "string", "description": "The product name." }, "type": { "type": "string", "description": "The WooCommerce product type, such as simple or variable." }, "status": { "type": "string", "enum": [ "any", "draft", "pending", "private", "publish" ], "description": "The WooCommerce product status." }, "sku": { "type": "string", "description": "The product SKU." }, "regularPrice": { "type": "string", "description": "The regular product price as a decimal string." }, "salePrice": { "type": "string", "description": "The sale product price as a decimal string." }, "description": { "type": "string", "description": "The full product description." }, "shortDescription": { "type": "string", "description": "The short product description." }, "manageStock": { "type": "boolean", "description": "Whether WooCommerce should manage stock for this product." }, "stockQuantity": { "type": "integer", "description": "The product stock quantity." }, "stockStatus": { "type": "string", "enum": [ "instock", "outofstock", "onbackorder" ], "description": "The WooCommerce stock status." }, "categories": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The WooCommerce term ID." } }, "additionalProperties": false, "description": "A WooCommerce taxonomy term reference used in write payloads." }, "description": "The product category references." }, "tags": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The WooCommerce term ID." } }, "additionalProperties": false, "description": "A WooCommerce taxonomy term reference used in write payloads." }, "description": "The product tag references." }, "images": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The existing WordPress media attachment ID." }, "src": { "type": "string", "description": "A public image URL WooCommerce can import." }, "name": { "type": "string", "description": "The image display name." }, "alt": { "type": "string", "description": "The image alt text." } }, "additionalProperties": false, "description": "A WooCommerce product image reference used in write payloads." }, "description": "The product image references." }, "attributes": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The existing WooCommerce attribute ID." }, "name": { "type": "string", "description": "The custom attribute name when no attribute ID is used." }, "position": { "type": "integer", "description": "The attribute display position." }, "visible": { "type": "boolean", "description": "Whether the attribute is visible on the product page." }, "variation": { "type": "boolean", "description": "Whether the attribute is used for variations." }, "options": { "type": "array", "items": { "type": "string", "description": "One attribute option." }, "description": "The attribute option labels." } }, "additionalProperties": false, "description": "A WooCommerce product attribute payload used in product writes." }, "description": "The product attributes." } }, "additionalProperties": false, "required": [ "productId" ], "description": "The input payload for updating a WooCommerce product." }, "outputSchema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce product ID." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The product name." }, { "type": "null" } ] }, "slug": { "anyOf": [ { "type": "string", "description": "The product URL slug." }, { "type": "null" } ] }, "permalink": { "anyOf": [ { "type": "string", "description": "The product permalink." }, { "type": "null" } ] }, "type": { "anyOf": [ { "type": "string", "description": "The WooCommerce product type." }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string", "description": "The product status." }, { "type": "null" } ] }, "sku": { "anyOf": [ { "type": "string", "description": "The product SKU." }, { "type": "null" } ] }, "price": { "anyOf": [ { "type": "string", "description": "The current product price as returned by WooCommerce." }, { "type": "null" } ] }, "regularPrice": { "anyOf": [ { "type": "string", "description": "The regular product price as returned by WooCommerce." }, { "type": "null" } ] }, "salePrice": { "anyOf": [ { "type": "string", "description": "The sale product price as returned by WooCommerce." }, { "type": "null" } ] }, "stockStatus": { "anyOf": [ { "type": "string", "description": "The product stock status." }, { "type": "null" } ] }, "stockQuantity": { "anyOf": [ { "type": "integer", "description": "The product stock quantity, if tracked." }, { "type": "null" } ] }, "categories": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce category ID." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The category display name." }, { "type": "null" } ] }, "slug": { "anyOf": [ { "type": "string", "description": "The category URL slug." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "One WooCommerce product category attached to a product." }, "description": "The product categories returned by WooCommerce." }, "images": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce image attachment ID." }, { "type": "null" } ] }, "src": { "anyOf": [ { "type": "string", "description": "The image URL." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The image display name." }, { "type": "null" } ] }, "alt": { "anyOf": [ { "type": "string", "description": "The image alt text." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "One WooCommerce product image." }, "description": "The product images returned by WooCommerce." } }, "additionalProperties": false, "description": "A normalized WooCommerce product." } }, { "id": "woocommerce.update_product_variation", "service": "woocommerce", "name": "update_product_variation", "description": "Update one WooCommerce product variation.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "productId": { "type": "integer", "minimum": 1, "description": "The WooCommerce product ID." }, "variationId": { "type": "integer", "minimum": 1, "description": "The WooCommerce variation ID." }, "sku": { "type": "string", "description": "The variation SKU." }, "regularPrice": { "type": "string", "description": "The regular variation price as a decimal string." }, "salePrice": { "type": "string", "description": "The sale variation price as a decimal string." }, "manageStock": { "type": "boolean", "description": "Whether WooCommerce should manage stock for this variation." }, "stockQuantity": { "type": "integer", "description": "The variation stock quantity." }, "stockStatus": { "type": "string", "enum": [ "instock", "outofstock", "onbackorder" ], "description": "The WooCommerce stock status." }, "attributes": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The existing WooCommerce attribute ID." }, "name": { "type": "string", "description": "The custom attribute name when no attribute ID is used." }, "option": { "type": "string", "description": "The selected attribute option." } }, "additionalProperties": false, "required": [ "option" ], "description": "A WooCommerce variation attribute payload." }, "description": "The variation attributes." }, "image": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The existing WordPress media attachment ID." }, "src": { "type": "string", "description": "A public image URL WooCommerce can import." }, "name": { "type": "string", "description": "The image display name." }, "alt": { "type": "string", "description": "The image alt text." } }, "additionalProperties": false, "description": "A WooCommerce product image reference used in write payloads." } }, "additionalProperties": false, "required": [ "productId", "variationId" ], "description": "The input payload for updating a WooCommerce product variation." }, "outputSchema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce variation ID." }, { "type": "null" } ] }, "sku": { "anyOf": [ { "type": "string", "description": "The variation SKU." }, { "type": "null" } ] }, "price": { "anyOf": [ { "type": "string", "description": "The current variation price as returned by WooCommerce." }, { "type": "null" } ] }, "regularPrice": { "anyOf": [ { "type": "string", "description": "The regular variation price as returned by WooCommerce." }, { "type": "null" } ] }, "salePrice": { "anyOf": [ { "type": "string", "description": "The sale variation price as returned by WooCommerce." }, { "type": "null" } ] }, "stockStatus": { "anyOf": [ { "type": "string", "description": "The variation stock status." }, { "type": "null" } ] }, "stockQuantity": { "anyOf": [ { "type": "integer", "description": "The variation stock quantity, if tracked." }, { "type": "null" } ] }, "attributes": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce attribute ID." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The attribute display name." }, { "type": "null" } ] }, "option": { "anyOf": [ { "type": "string", "description": "The selected attribute option." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce variation attribute." }, "description": "The variation attributes returned by WooCommerce." }, "image": { "anyOf": [ { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WooCommerce image attachment ID." }, { "type": "null" } ] }, "src": { "anyOf": [ { "type": "string", "description": "The image URL." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "description": "The image display name." }, { "type": "null" } ] }, "alt": { "anyOf": [ { "type": "string", "description": "The image alt text." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "One WooCommerce product image." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WooCommerce product variation." } }, { "id": "woocommerce.upload_media", "service": "woocommerce", "name": "upload_media", "description": "Upload one media file to the WordPress media library used by WooCommerce.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "file": { "type": "object", "properties": { "fileId": { "type": "string", "minLength": 1, "description": "The transit file identifier returned by POST /api/files." }, "name": { "type": "string", "minLength": 1, "description": "Optional filename override to send to the provider." }, "mimeType": { "type": "string", "minLength": 1, "description": "Optional MIME type override to send to the provider." } }, "additionalProperties": false, "required": [ "fileId" ], "description": "A file previously uploaded to the local transit file API." }, "fileUrl": { "type": "string", "description": "A public URL to download and upload to WordPress media.", "format": "uri" }, "contentBase64": { "type": "string", "description": "Base64-encoded file content to upload." }, "fileName": { "type": "string", "description": "The file name sent to WordPress media." }, "mimeType": { "type": "string", "description": "The MIME type sent to WordPress media." }, "title": { "type": "string", "description": "The media title." }, "altText": { "type": "string", "description": "The media alt text." } }, "additionalProperties": false, "description": "The input payload for uploading one WordPress media item." }, "outputSchema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The WordPress media item ID." }, { "type": "null" } ] }, "sourceUrl": { "anyOf": [ { "type": "string", "description": "The public source URL of the media file." }, { "type": "null" } ] }, "mediaType": { "anyOf": [ { "type": "string", "description": "The WordPress media type." }, { "type": "null" } ] }, "mimeType": { "anyOf": [ { "type": "string", "description": "The media MIME type." }, { "type": "null" } ] }, "title": { "anyOf": [ { "type": "string", "description": "The rendered media title." }, { "type": "null" } ] }, "altText": { "anyOf": [ { "type": "string", "description": "The media alt text." }, { "type": "null" } ] }, "metadataUpdated": { "anyOf": [ { "type": "boolean", "description": "Whether the requested media metadata update was applied." }, { "type": "null" } ] }, "metadataError": { "anyOf": [ { "type": "string", "description": "The media metadata update error message when the file upload succeeded." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "A normalized WordPress media item." } } ] }