Publish collection items with the Webflow API
Publishes items of a collection to the live site without publishing the rest of the site. Returns publishedItemIds and errors.
- Identifier
- webflow_publish_collection_items
The request
POST https://connect.reportei.com/api/tools/webflow_publish_collection_items/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"collection_id": "<collection_id>",
"itemIds": []
}
}Your system sends your customer's connection id and the tool arguments. The headers are the same as the rest of the Connect API: your product's token and your customer's token.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| collection_id | string | Yes | Id of the collection, from List collections. |
| itemIds | array | Yes | Ids of the items, from List collection items or Create collection item. |
Supported connections
Your customer connects their Webflow account once, with one of the modes below. The same connection serves every tool of the toolkit.
API key
Your customer pastes the app's key on a Connect screen, or your system sends the key with POST /api/customer-toolkits, with no screen.
OAuth with your product's app
You register your product's OAuth app once, with POST /api/merchants/credentials/webflow, and your customer authorizes the account on a consent screen. Connect renews the token when it is about to expire.
The response
On success, Connect preserves the app's response status and body. HTTP errors returned by the app use the {error, api_error} envelope; authentication or validation can fail before execution. The X-Toolkit-Execution-Id header identifies the recorded execution, available at GET /api/tools/executions/{uuid}.
Ready for AI agents
This tool's input is a JSON Schema, available at GET /api/tools/webflow_publish_collection_items. It becomes your agent's tool definition with no conversion.
Other Webflow tools
- List sitesGETLists the sites the connection reaches, with the id that the other tools ask for as site_id and the customDomains of each site with their ids. A site token reaches only its own site.
- Publish sitePOSTPublishes the site with all its staged changes to the chosen domains. Send customDomains, publishToWebflowSubdomain or both. Webflow allows one successful publish per minute.
- List collectionsGETLists the CMS collections of a site, with the id that the item tools ask for as collection_id.
- Get collectionGETReturns a collection with its fields: the slug, type and isRequired of each one. The field slugs are the keys of fieldData in Create collection item and Update collection item.
- List collection itemsGETLists the items of a collection as they are before publishing, drafts included, with fieldData keyed by field slug. The response has pagination with limit, offset and total: the last page is when offset plus limit reaches total.
- Get collection itemGETReturns an item of a collection as it is before publishing, with its fieldData, isDraft and isArchived.
- Create collection itemPOSTCreates an item in a collection and returns it. The item is a draft unless isDraft is false, which queues it for the next site publish. To put it live right away, use Publish collection items.
- Update collection itemPATCHUpdates an item of a collection and returns it. Only the fields sent in fieldData change. Changes to an item that is already live reach the site with Publish collection items or Publish site.
Toolkits in the same category
See all 100 toolkitsSee Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
