--- updatedAt: 2026-09-21T10:35:17.000Z agentTools: projectIndex: https://developers.marq.com/llms.txt --- # Create Project Creates a new project from a template within Marq. Requires the project.content scope and user access to the template used to create the project. *** ### OAuth 2.0 User Token and Account Token Scopes: [Project.Content](https://developers.marq.com/reference/access-token-scopes) *** # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "marq-v1", "version": "1" }, "servers": [ { "url": "https://api.marq.com/" } ], "components": { "securitySchemes": { "sec0": { "type": "oauth2", "flows": { "clientCredentials": { "tokenUrl": "https://example.com/oauth2/token", "scopes": {} } } } } }, "security": [ { "sec0": [] } ], "paths": { "/v1/projects": { "post": { "summary": "Create Project", "description": "", "operationId": "create-project", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "templateId", "creatorId" ], "properties": { "templateId": { "type": "string", "description": "The ID of the template from which you will use to create the project" }, "creatorId": { "type": "integer", "description": "The user ID that will be the creator and owner of the project.", "format": "int32" }, "folderId": { "type": "integer", "description": "The folder ID where the project will be created.", "format": "int32" }, "title": { "type": "string", "description": "By default projects will have the title copied from the template title. If you wish to override and create a new project title, use this parameter to pass in the project title value." }, "insertpageTemplates": { "type": "array", "description": "Projects will have all the standard pages from the template, but if you need to add ad hoc pages from the templates library of page templates, use the Page Template name and the page number to insert the order.", "items": { "properties": { "name": { "type": "string", "description": "The name of the page template to be added to the project. It must be the exact match of the page template." }, "pageNumber": { "type": "integer", "description": "The number of order to insert the page template into the project. All pages that exist in the template will be moved in order.", "format": "int32" } }, "type": "object" } }, "dataSmartFields": { "type": "array", "description": "To automatically apply a data item to a project from a pre-existing data set in Marq, add the key/value pair for the data item. If data items share the same IDs (IDs are not unique), send multiple sets of key/value pairs to filter to one specific data item.", "items": { "properties": { "column": { "type": "string", "description": "The column name within your Marq Dataset (the key)" }, "value": { "type": "string", "description": "The value of your data item within the key. (e.g. AEG32 for the opportunity ID or 7645 for the MLS Number)" } }, "required": [ "column", "value" ], "type": "object" } }, "projectSmartFields": { "type": "array", "description": "Project smart fields allow you to automatically populate text fields or images from metadata within your payload. The name of the Smart field needs to match the same name used within the template in order to populate. If a smart field is sent within the payload of this API, but the template does not have it added, the smart field will automatically be created with the value pre-filled and will able to be used in the project if the user decides to add the smart field within the project.", "items": { "properties": { "name": { "type": "string", "description": "This is the smart field variable name and must match the exact name that exists in the template." }, "value": { "type": "string", "description": "The text, color hex code, or image URL link to populate the Smart field placeholder." }, "dataType": { "type": "string", "description": "Data type will default to text if unprovided. Provide the type of smart field to apply color fill to a shape or insert image.", "enum": [ "text", "image", "color" ] } }, "required": [ "name", "value" ], "type": "object" } } } } } } }, "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"id\": \"1603e295-d271-478b-b542-8fa91dc1d777\",\n \"selfUri\": \"https://api.marq.com/v1/users/164182250/projects/1603e295-d271-478b-b542-8fa91dc1d777\",\n \"title\": \"Sales Presentation\",\n \"editorUri\": \"https://app.marq.com/documents/edit/1603e295-d271-478b-b542-8fa91dc1d777\",\n \"publishedUri\": null,\n \"thumbnailUri\": \"https://app.marq.com/documents/thumb/1603e295-d271-478b-b542-8fa91dc1d777/0/1/NULL/400\",\n \"ownerId\": 164182200,\n \"created\": \"2024-07-24T15:24:14Z\",\n \"lastModified\": \"2024-07-24T15:24:14Z\",\n \"templateId\": \"4361c440-b341-4504-a0c3-387d118a9y65\",\n \"dataItemUsages\": []\n}" } }, "schema": { "type": "object", "properties": { "id": { "type": "string", "example": "1603e295-d271-478b-b542-8fa91dc1d777" }, "selfUri": { "type": "string", "example": "https://api.marq.com/v1/users/164182250/projects/1603e295-d271-478b-b542-8fa91dc1d777" }, "title": { "type": "string", "example": "Sales Presentation" }, "editorUri": { "type": "string", "example": "https://app.marq.com/documents/edit/1603e295-d271-478b-b542-8fa91dc1d777" }, "publishedUri": {}, "thumbnailUri": { "type": "string", "example": "https://app.marq.com/documents/thumb/1603e295-d271-478b-b542-8fa91dc1d777/0/1/NULL/400" }, "ownerId": { "type": "integer", "example": 164182200, "default": 0 }, "created": { "type": "string", "example": "2024-07-24T15:24:14Z" }, "lastModified": { "type": "string", "example": "2024-07-24T15:24:14Z" }, "templateId": { "type": "string", "example": "4361c440-b341-4504-a0c3-387d118a9y65" }, "dataItemUsages": { "type": "array", "items": { "type": "object", "properties": {} } } } } } } }, "400": { "description": "400", "content": { "application/json": { "examples": { "Result": { "value": "{}" } }, "schema": { "type": "object", "properties": {} } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```