POST

Create Project


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 project.

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/projects

Body Params
projectProjectRequired

Project to create.

Response Object
projectProject

Created project.

Create Project
Request
cURL
curl -X POST \ 'https://www.wixapis.com/api/v1/portfolio/projects' \ -H 'Authorization: <AUTH>' \ -H 'Content-Type: application/json' \ -d '{ "project": { "title": "Project Title", "description": "This is a project description.", "hidden": false, "collectionIds": ["123e4567-e89b-12d3-a456-426614174001"], "slug": "new-project-title", "coverImage": { "imageInfo": { "id": "9ab44e4567-e89b-12d3-a456-4266141747", "url": "https://example.com/cover_image.jpg", } }, } }'
Response
JSON
{ "project": { "id": "123e4567-e89b-12d3-a456-426614174000", "revision": 1, "title": "Project Title", "description": "This is a project description.", "hidden": false, "collectionIds": ["123e4567-e89b-12d3-a456-426614174001"], "slug": "new-project-title", "coverImage": { "imageInfo": { "id": "9ab44e4567-e89b-12d3-a456-4266141747", "url": "https://example.com/cover_image.jpg" } }, "createdDate": "2024-07-31T12:00:00Z", "updatedDate": "2024-09-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?