--- updatedAt: 2026-09-21T10:35:23.000Z agentTools: projectIndex: https://developers.marq.com/llms.txt --- # Create user # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "scim", "version": "1" }, "servers": [ { "url": "https://users.app.marq.com/scim/v2/press" } ], "components": { "securitySchemes": { "sec0": { "type": "oauth2", "flows": { "clientCredentials": { "tokenUrl": "https://example.com/oauth2/token", "scopes": {} } } } } }, "security": [ { "sec0": [] } ], "paths": { "/users": { "post": { "summary": "Create user", "description": "", "operationId": "create-user", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "userName", "emails" ], "properties": { "userName": { "type": "string", "description": "The user's username (usually their email)." }, "name": { "type": "object", "description": "An object representing a user's name in various formats.", "properties": { "formatted": { "type": "string", "description": "The users first and last name." }, "givenName": { "type": "string", "description": "The user's first name." }, "familyName": { "type": "string", "description": "The user's last name." } } }, "emails": { "type": "array", "description": "Emails associated to the user that can be utilized for user smart fields.", "items": { "properties": { "value": { "type": "string", "description": "The user's email address" }, "primary": { "type": "boolean", "description": "Used to determine the primary email of the emails given." } }, "type": "object" } }, "active": { "type": "boolean", "description": "User's access status (whether a user can log into Marq platform)." }, "roles": { "type": "array", "description": "A list of administrative roles assigned to the user. Assigning a role to a user allows that user to perform administrative actions associated with that role. Roles can include: `Billing Admin`, `Team Admin`, `Template Admin`, `Print Approver`, `Document Approver`, `Data Admin`, `Analytics User`, `Campaigns User`", "items": { "type": "string" } }, "displayName": { "type": "string", "description": "The name that is displayed and represents the user (usually their email)." }, "urn:ietf:params:scim:schemas:extension:lucidpress:1": { "properties": { "0:UserFields": { "type": "object", "description": "Custom user attributes that can be used for user smart fields to auto populate text placeholders within a Marq template/project.", "properties": {} } }, "required": [], "type": "object" }, "urn:ietf:params:scim:schemas:extension:marq:1": { "properties": { "0:User": { "type": "object", "properties": { "billingCode": { "type": "string" }, "officeIdAtPrintVendor": { "type": "string" }, "userIdAtPrintVendor": { "type": "string" }, "primaryGroup": { "type": "string" }, "hasLicense": { "type": "string" } } } }, "required": [], "type": "object" }, "password": { "type": "string", "description": "Passwords must be at least 8 characters in length." } } } } } }, "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"schemas\": [\n \"urn:ietf:params:scim:api:messages:2.0:ListResponse\"\n ],\n \"totalResults\": 1,\n \"startIndex\": 1,\n \"itemsPerPage\": 100,\n \"Resources\": [\n {\n \"urn:lucidchart:schemas:1.0:User\": {\n \"canEdit\": true,\n \"addOns\": []\n },\n \"displayName\": \"sarah.anderson@mossdemo.com\",\n \"roles\": [\n \"Billing Admin\",\n \"Team Admin\",\n \"Template Admin\",\n \"Print Approver\",\n \"Document Approver\",\n \"Data Admin\",\n \"Analytics User\",\n \"Campaigns User\"\n ],\n \"canEdit\": true,\n \"active\": true,\n \"userName\": \"sarah.anderson@mossdemo.com\",\n \"urn:ietf:params:scim:schemas:extension:lucidpress:1.0:UserFields\": {\n \"website\": \"https://www.marq.com\",\n \"disclaimer\": \"All information provided is deemed reliable but is not guaranteed and should be independently verified.\",\n \"profileImage\": \"https://images.app.marq.com/images/2da46b03-8174-41f9-ae86-d0674dea3142?product=press\",\n \"Facebook URL\": \"https://www.facebook.com/marqhq/\",\n \"address\": \"142 Wild Rose Street, San Antonio, Texas, 78015\",\n \"Twitter URL\": \"https://twitter.com/marq_hq\",\n \"title\": \"Account Executive\",\n \"workPhone\": \"(316) 137-5195\",\n \"Role Description\": \"Lead Consultant: Team and client lead for strategic and technical direction, and ongoing client relations manager\",\n \"LinkedIn URL\": \"https://www.linkedin.com/company/marqhq/\",\n \"fullName\": \"Sarah Anderson\",\n \"Instagram URL\": \"https://www.instagram.com/buildonmarq/\",\n \"company\": \"Anderson & Thomas Office}\",\n \"cellPhone\": \"(316) 137-5066\"\n },\n \"emails\": [\n {\n \"value\": \"sarah.anderson@mossdemo.com\",\n \"primary\": true\n }\n ],\n \"urn:ietf:params:scim:schemas:extension:lucidchart:1.0:User\": {\n \"canEdit\": true,\n \"addOns\": []\n },\n \"meta\": {\n \"resourceType\": \"User\",\n \"created\": \"2024-04-11T05:26:01Z\",\n \"lastModified\": \"2025-04-11T06:33:56Z\",\n \"version\": \"W/\\\"1744353236000\\\"\",\n \"location\": \"https://users.app.marq.com/scim/v2/press/Users/lucid-164182504\"\n },\n \"urn:ietf:params:scim:schemas:extension:marq:1.0:User\": {\n \"billingCode\": null,\n \"hasLicense\": true,\n \"officeIdAtPrintVendor\": null,\n \"userIdAtPrintVendor\": null,\n \"primaryGroup\": null\n },\n \"schemas\": [\n \"urn:ietf:params:scim:schemas:core:2.0:User\",\n \"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User\",\n \"urn:lucidchart:schemas:1.0:User\",\n \"urn:ietf:params:scim:schemas:extension:lucidchart:1.0:User\",\n \"urn:ietf:params:scim:schemas:extension:lucid:1.0:User\",\n \"urn:ietf:params:scim:schemas:extension:lucid:2.0:User\",\n \"urn:ietf:params:scim:schemas:extension:marq:1.0:User\"\n ],\n \"name\": {\n \"formatted\": \"Sarah Anderson\",\n \"givenName\": \"Sarah\",\n \"familyName\": \"Anderson\"\n },\n \"urn:ietf:params:scim:schemas:extension:lucid:1.0:User\": {\n \"billingCode\": null,\n \"productLicenses\": {\n \"Marq\": true\n },\n \"officeIdAtPrintVendor\": null,\n \"userIdAtPrintVendor\": null,\n \"primaryGroup\": null\n },\n \"urn:ietf:params:scim:schemas:extension:lucid:2.0:User\": {\n \"billingCode\": null,\n \"userIdAtPrintVendor\": null,\n \"officeIdAtPrintVendor\": null,\n \"primaryGroup\": null,\n \"productLicenses\": {\n \"Marq\": true\n }\n },\n \"id\": \"lucid-164182504\"\n }\n ]\n}" } }, "schema": { "type": "object", "properties": { "schemas": { "type": "array", "items": { "type": "string", "example": "urn:ietf:params:scim:api:messages:2.0:ListResponse" } }, "totalResults": { "type": "integer", "example": 1, "default": 0 }, "startIndex": { "type": "integer", "example": 1, "default": 0 }, "itemsPerPage": { "type": "integer", "example": 100, "default": 0 }, "Resources": { "type": "array", "items": { "type": "object", "properties": { "urn:lucidchart:schemas:1.0:User": { "type": "object", "properties": { "canEdit": { "type": "boolean", "example": true, "default": true }, "addOns": { "type": "array", "items": { "type": "object", "properties": {} } } } }, "displayName": { "type": "string", "example": "sarah.anderson@mossdemo.com" }, "roles": { "type": "array", "items": { "type": "string", "example": "Billing Admin" } }, "canEdit": { "type": "boolean", "example": true, "default": true }, "active": { "type": "boolean", "example": true, "default": true }, "userName": { "type": "string", "example": "sarah.anderson@mossdemo.com" }, "urn:ietf:params:scim:schemas:extension:lucidpress:1.0:UserFields": { "type": "object", "properties": { "website": { "type": "string", "example": "https://www.marq.com" }, "disclaimer": { "type": "string", "example": "All information provided is deemed reliable but is not guaranteed and should be independently verified." }, "profileImage": { "type": "string", "example": "https://images.app.marq.com/images/2da46b03-8174-41f9-ae86-d0674dea3142?product=press" }, "Facebook URL": { "type": "string", "example": "https://www.facebook.com/marqhq/" }, "address": { "type": "string", "example": "142 Wild Rose Street, San Antonio, Texas, 78015" }, "Twitter URL": { "type": "string", "example": "https://twitter.com/marq_hq" }, "title": { "type": "string", "example": "Account Executive" }, "workPhone": { "type": "string", "example": "(316) 137-5195" }, "Role Description": { "type": "string", "example": "Lead Consultant: Team and client lead for strategic and technical direction, and ongoing client relations manager" }, "LinkedIn URL": { "type": "string", "example": "https://www.linkedin.com/company/marqhq/" }, "fullName": { "type": "string", "example": "Sarah Anderson" }, "Instagram URL": { "type": "string", "example": "https://www.instagram.com/buildonmarq/" }, "company": { "type": "string", "example": "Anderson & Thomas Office}" }, "cellPhone": { "type": "string", "example": "(316) 137-5066" } } }, "emails": { "type": "array", "items": { "type": "object", "properties": { "value": { "type": "string", "example": "sarah.anderson@mossdemo.com" }, "primary": { "type": "boolean", "example": true, "default": true } } } }, "urn:ietf:params:scim:schemas:extension:lucidchart:1.0:User": { "type": "object", "properties": { "canEdit": { "type": "boolean", "example": true, "default": true }, "addOns": { "type": "array", "items": { "type": "object", "properties": {} } } } }, "meta": { "type": "object", "properties": { "resourceType": { "type": "string", "example": "User" }, "created": { "type": "string", "example": "2024-04-11T05:26:01Z" }, "lastModified": { "type": "string", "example": "2025-04-11T06:33:56Z" }, "version": { "type": "string", "example": "W/\"1744353236000\"" }, "location": { "type": "string", "example": "https://users.app.marq.com/scim/v2/press/Users/lucid-164182504" } } }, "urn:ietf:params:scim:schemas:extension:marq:1.0:User": { "type": "object", "properties": { "billingCode": {}, "hasLicense": { "type": "boolean", "example": true, "default": true }, "officeIdAtPrintVendor": {}, "userIdAtPrintVendor": {}, "primaryGroup": {} } }, "schemas": { "type": "array", "items": { "type": "string", "example": "urn:ietf:params:scim:schemas:core:2.0:User" } }, "name": { "type": "object", "properties": { "formatted": { "type": "string", "example": "Sarah Anderson" }, "givenName": { "type": "string", "example": "Sarah" }, "familyName": { "type": "string", "example": "Anderson" } } }, "urn:ietf:params:scim:schemas:extension:lucid:1.0:User": { "type": "object", "properties": { "billingCode": {}, "productLicenses": { "type": "object", "properties": { "Marq": { "type": "boolean", "example": true, "default": true } } }, "officeIdAtPrintVendor": {}, "userIdAtPrintVendor": {}, "primaryGroup": {} } }, "urn:ietf:params:scim:schemas:extension:lucid:2.0:User": { "type": "object", "properties": { "billingCode": {}, "userIdAtPrintVendor": {}, "officeIdAtPrintVendor": {}, "primaryGroup": {}, "productLicenses": { "type": "object", "properties": { "Marq": { "type": "boolean", "example": true, "default": true } } } } }, "id": { "type": "string", "example": "lucid-164182504" } } } } } } } } }, "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 } ```