pm-webflow
Webflow connector knowledge and safe action guide.
- License 许可
- AGPL-3.0
- 最近更新
- 2026-09-21
- Stars
- ★ 7
- Forks
- 0
01 前言 Front Matter
- name
- pm-webflow
- description
- Webflow connector knowledge and safe action guide.
03 SKILL.md 正文
pm-webflow
Purpose
Reads Webflow sites, collections, collection items, pages, forms, form submissions, assets, asset folders, webhooks, redirects, custom domains, components, orders, products, and ecommerce settings, and writes CMS collection-item lifecycle actions, form-submission hidden-field updates, asset metadata, webhook subscriptions, and ecommerce order/inventory mutations, using the Webflow Data API v2.
Icon
- id: webflow
- asset: icons/webflow.svg
- source: upstream_registry
- review_status: upstream_seeded
- review_url: https://developers.webflow.com/data/reference
Capabilities
- check=true catalog=true read=true write=true query=false
- Integration type: api
Authentication
- Use pm credentials add with --from-env or --value-stdin for secret fields.
Configuration
- accept_version
- base_url
- mode
- site_id (required)
- api_key (secret) (required)
ETL Streams
- collections:
- primary key: id
- fields: displayName(string), id(string), slug(string)
- pages:
- primary key: id
- fields: id(string), slug(string), title(string)
- forms:
- primary key: id
- fields: createdOn(string), displayName(string), id(string)
- sites:
- primary key: id
- fields: createdOn(string), displayName(string), id(string), lastPublished(string), lastUpdated(string), parentFolderId(string), shortName(string), timeZone(string), workspaceId(string)
- assets:
- primary key: id
- fields: altText(string), contentType(string), createdOn(string), displayName(string), hostedUrl(string), id(string), lastUpdated(string), originalFileName(string), siteId(string), size(integer)
- webhooks:
- primary key: id
- fields: createdOn(string), filter(object), id(string), lastTriggered(string), siteId(string), triggerType(string), url(string), workspaceId(string)
- redirects:
- primary key: id
- fields: fromUrl(string), id(string), toUrl(string)
- form_submissions:
- primary key: id
- fields: dateSubmitted(string), displayName(string), formId(string), formResponse(object), id(string), localeId(string), siteId(string), workspaceId(string)
- orders:
- primary key: orderId
- fields: acceptedOn(string), comment(string), customerInfo(object), customerPaymentDetails(object), fulfilledOn(string), orderComment(string), orderId(string), purchasedItems(array), refundedOn(string), shippingAddress(object), status(string)
- products:
- primary key: product_id
- fields: product(object), product_id(string), skus(array)
- custom_domains:
- primary key: id
- fields: id(string), lastPublished(string), url(string)
- components:
- primary key: id
- fields: description(string), group(string), id(string), name(string), readonly(boolean)
- asset_folders:
- primary key: id
- fields: assets(array), createdOn(string), displayName(string), id(string), parentFolder(string), siteId(string)
- ecommerce_settings:
- primary key: siteId
- fields: createdOn(string), defaultCurrency(string), siteId(string)
- collection_items:
- primary key: id
- cursor: lastUpdated
- fields: cmsLocaleId(string), collectionId(string), createdOn(string), fieldData(object), id(string), isArchived(boolean), isDraft(boolean), lastPublished(string), lastUpdated(string)
Sync Modes
- ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped, incremental_append, incremental_append_deduped
Reverse ETL Actions
- create_collection_item:
- endpoint: POST /v2/collections/{{ record.collection_id }}/items
- required fields: collection_id, fieldData
- optional fields: isArchived, isDraft, cmsLocaleId
- risk: creates a new staged (unpublished-to-live) CMS item in the given collection; consumes the site's CMS item quota; the item is not visible on the live site until a subsequent publish_collection_item call
- update_collection_item:
- endpoint: PATCH /v2/collections/{{ record.collection_id }}/items/{{ record.id }}
- required fields: collection_id, id
- optional fields: fieldData, isArchived, isDraft, cmsLocaleId
- risk: overwrites staged field data on an existing CMS item (primary locale only, unless cmsLocaleId is set); changes are not visible on the live site until a subsequent publish_collection_item call
- delete_collection_item:
- endpoint: DELETE /v2/collections/{{ record.collection_id }}/items/{{ record.id }}
- required fields: collection_id, id
- risk: permanently removes a staged CMS item from the collection; if the item was previously published live, it remains live until a subsequent unpublish, since delete only affects the staged copy per Webflow's staged/live item model
- publish_collection_item:
- endpoint: POST /v2/collections/{{ record.collection_id }}/items/publish
- required fields: collection_id, itemIds
- risk: publishes the current staged content of the named item ids live immediately, making them visible on the site's live domain(s); does not itself trigger a full site publish/build
- update_form_submission:
- endpoint: PATCH /v2/sites/{{ config.site_id }}/form_submissions/{{ record.id }}
- required fields: id, formSubmissionData
- risk: overwrites the values of hidden fields already defined on the form's schema for one submission; cannot add new fields or edit visible/user-submitted answers
- update_asset:
- endpoint: PATCH /v2/assets/{{ record.id }}
- required fields: id
- optional fields: displayName, altText
- risk: renames or re-captions an existing site asset (display name / alt text only); does not replace the underlying file
- delete_asset:
- endpoint: DELETE /v2/assets/{{ record.id }}
- required fields: id
- risk: permanently deletes an uploaded asset from the site's asset library; any live page still referencing the asset's URL will show a broken image/file link
- create_webhook:
- endpoint: POST /v2/sites/{{ config.site_id }}/webhooks
- required fields: triggerType, url
- optional fields: filter
- risk: registers a new outbound webhook subscription for the site (up to 75 per triggerType); Webflow will begin POSTing event payloads to the given url immediately for matching events
- delete_webhook:
- endpoint: DELETE /v2/webhooks/{{ record.id }}
- required fields: id
- risk: permanently removes a webhook subscription; Webflow stops sending event payloads for it immediately
- update_order:
- endpoint: PATCH /v2/sites/{{ config.site_id }}/orders/{{ record.orderId }}
- required fields: orderId
- optional fields: comment, shippingProvider, shippingTracking, shippingTrackingURL
- risk: updates internal order record-keeping fields (comment/shipping provider/tracking number/tracking URL) on a live ecommerce order; does not change order status or trigger customer notifications by itself
- fulfill_order:
- endpoint: POST /v2/sites/{{ config.site_id }}/orders/{{ record.orderId }}/fulfill
- required fields: orderId
- optional fields: sendOrderFulfilledEmail
- risk: marks a real customer order as fulfilled and, unless sendOrderFulfilledEmail is explicitly set false, sends the customer a fulfillment notification email
- refund_order:
- endpoint: POST /v2/sites/{{ config.site_id }}/orders/{{ record.orderId }}/refund
- required fields: orderId
- risk: DESTRUCTIVE FINANCIAL ACTION: reverses the underlying Stripe charge and refunds the customer's payment in full, setting the order's status to refunded; cannot be undone through the API
- update_inventory:
- endpoint: PATCH /v2/collections/{{ record.sku_collection_id }}/items/{{ record.sku_id }}/inventory
- required fields: sku_collection_id, sku_id, inventoryType
- optional fields: quantity, updateQuantity
- risk: changes live storefront stock levels for a SKU either absolutely (quantity) or incrementally (updateQuantity); an incorrect value can oversell or wrongly zero-out a product's live availability
Security
- read risk: external Webflow API read of site collections, pages, forms, assets, webhooks, redirects, ecommerce orders/products, and CMS collection items for a configured site
- write risk: external mutations against a live Webflow site: CMS collection-item create/update/delete/publish, form-submission hidden-field updates, asset rename/delete, webhook subscribe/unsubscribe, and ecommerce order fulfillment/refund/inventory changes; publish/fulfill/refund actions have customer- or site-visitor-visible side effects and refund is irreversible
- approval: required for all write actions; refund_order and publish_collection_item are high-risk (irreversible financial action / immediate live-site visibility) and should be gated more strictly than the others
- Never pass secret values in chat, shell arguments, logs, docs, or JSON output.
Commands
Inspect as a manual
pm connectors inspect webflow
Inspect as structured JSON
pm connectors inspect webflow --json
Agent Rules
- Run pm connectors inspect webflow before creating credentials or plans.
- Use --json only when the caller needs structured output; use the manual for human-readable guidance.
- Never ask the user to paste secret values into chat.
- For reverse ETL writes, create a plan, show the preview, wait for explicit approval, then run with the approval token.
04 同仓库更多 Skills
recipe-preview-approve-reverse-etl
Preview and approve a reverse ETL plan safely.
recipe-github-prs-to-warehouse
Sync GitHub pull requests into the local warehouse.
pm-zoom
Zoom connector knowledge and safe action guide.
pm-zonka-feedback
Zonka Feedback connector knowledge and safe action guide.
pm-zoho-invoice
Zoho Invoice connector knowledge and safe action guide.
pm-zoho-inventory
Zoho Inventory connector knowledge and safe action guide.