POST

Create Project Item


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

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

Body Params
itemItemRequired

Project item to create.

Response Object
itemItem

Newly created project item.

Create Project Item
Request
cURL
curl -X POST \ 'https://www.wixapis.com/portfolio/v1/Items' \ -H 'Authorization: <AUTH>' \ -H 'Content-Type: application/json' \ -d '{ "item": { "projectId": "123e4567-e89b-12d3-a456-426614174000", "sortOrder": 1.0, "title": "Lonely", "description": "This is the Lonely song image cover.", "image": { "imageInfo": { "id": "23ff-66b77-888aaf-9c45227e, } }, "link": { "text": "Listen to the song", "url": "https://lonely-song.com", "target": "_blank" } } }'
Response
JSON
{ "item": { "id": "456e7890-e89b-12d3-a456-426614174000", "projectId": "123e4567-e89b-12d3-a456-426614174000", "title": "Lonely", "description": "This is the Lonely song image cover.", "sortOrder": 1.0, "type": "IMAGE", "image": { "imageInfo": { "id": "23ff-66b77-888aaf-9c45227e" } }, "createdDate": "2024-07-31T12:00:00Z", "updatedDate": "2024-07-31T12:00:00Z", "link": { "text": "Listen to the song", "url": "https://lonely-song.com", "target": "_blank" } } }
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?