View as Markdown
Everstox icon

Everstox ACTION

Create Fulfillment Update Request

Creates a new fulfillment update request for a specific fulfillment. The fulfillment must be in in_fulfillment state. Use this to modify items, quantities, prices, addresses, or priority on an active fulfillment. fulfillment_items must include at least one item with a valid SKU; price_set quantities must sum to the item quantity. Address fields first_name/last_name or company are conditionally required (at least one set must be present). See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Everstox account once, then configure and run Create Fulfillment Update Request from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "everstox-create-fulfillment-update-request",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    everstox: { authProvisionId: "apn_xxxxxxx" },
    fulfillmentId: "Fulfillment ID",
    fulfillmentItems: "Fulfillment Items",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Fulfillment Update Request inputs
Property Type Description
fulfillmentId Fulfillment ID string
The UUID of the fulfillment to update, for example 550e8400-e29b-41d4-a716-446655440000. Obtain this from the fulfillment object you want to modify. Must be in in_fulfillment state.
Required
fulfillmentItems Fulfillment Items string
JSON array of fulfillment items to update. Must contain at least one item. Omit id when adding a new item; include it when updating an existing one. Each item requires a product.sku and a price_set with at least one entry. Example: [{"id": "550e8400-e29b-41d4-a716-446655440000", "quantity": 2, "product": {"sku": "PROD-001"}, "price_set": [{"quantity": 2, "currency": "EUR", "price_net_after_discount": "19.99", "tax_amount": "3.80", "tax_rate": "0.19"}]}]
Optional
shippingAddress Shipping Address string
JSON object with the complete shipping address. Required fields: country_code (ISO 2-letter, e.g. "DE"), country (full country name, e.g. "Germany"), city, zip, address_1, and at least one of first_name/last_name or company. Optional: address_2, title, phone, province_code, address_type (private or business). Example: {"first_name": "John", "last_name": "Doe", "country_code": "DE", "country": "Germany", "city": "Berlin", "zip": "10115", "address_1": "Musterstra\u00dfe 1", "address_type": "private"}
Optional
billingAddress Billing Address string
JSON object with the complete billing address. Required fields: country_code (ISO 2-letter, e.g. "DE"), country (full country name, e.g. "Germany"), city, zip, address_1, and at least one of first_name/last_name or company. Optional: address_2, title, phone, VAT_number, address_type (private or business). Example: {"first_name": "John", "last_name": "Doe", "country_code": "DE", "country": "Germany", "city": "Berlin", "zip": "10115", "address_1": "Musterstra\u00dfe 1", "address_type": "private"}
Optional
fulfillmentPriority Fulfillment Priority integer
Priority level for the fulfillment. Must be between 1 (highest) and 99 (lowest).
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
everstox-create-fulfillment-update-request
Version
0.0.2
App
Everstox
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes