POST

Create Collection


Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Creates a collection.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage Portfolio
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/portfolio/v1/collections

Body Params
collectionCollectionRequired

Collection to create.

Response Object
collectionCollection

Created collection.

Create Collection
Request
cURL
curl -X POST \ 'https://www.wixapis.com/portfolio/v1/collections' \ -H 'Authorization: <AUTH>' \ -H 'Content-Type: application/json' \ -d '{ "collection": { "title": "New Collection Title", "description": "This is a new collection description.", "slug": "new-collection-title", "coverImage": { "imageInfo": { "id": "8c074c67-2926-4518-92ef-c79d7810b3a4" } }, "hidden": false, "sortOrder": 1.0, "seoData": { "settings": { "keywords": [ { "isMain": true, "origin": "marketing-persona", "term": "investment management" } ], "preventAutoRedirect": false }, "tags": [ { "children": "Investment Experts Share Growth Strategies", "custom": false, "disabled": false, "type": "title" }, { "children": "", "custom": false, "disabled": false, "props": { "content": "Investment strategies explained by investment experts. Investment experts offer valuable insights for growth.", "name": "description" }, "type": "meta" } ] } } }'
Response
JSON
{ "collection": { "id": "123e4567-e89b-12d3-a456-426614174000", "revision": 1, "title": "New Collection Title", "description": "This is a new collection description.", "slug": "new-collection-title", "coverImage": { "imageInfo": { "id": "8c074c67-2926-4518-92ef-c79d7810b3a4" } } "hidden": false, "sortOrder": 1.0, "createdDate": "2024-07-31T12:00:00Z", "updatedDate": "2024-07-31T12:00:00Z", "seoData": { "settings": { "keywords": [ { "isMain": true, "origin": "marketing-persona", "term": "investment management" } ], "preventAutoRedirect": false }, "tags": [ { "children": "Investment Experts Share Growth Strategies", "custom": false, "disabled": false, "type": "title" }, { "children": "", "custom": false, "disabled": false, "props": { "content": "Investment strategies explained by investment experts. Investment experts offer valuable insights for growth.", "name": "description" }, "type": "meta" } ] } } }
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Event TriggersThis method triggers the following events:
Did this help?