Projects
Create Project
Projects
Create Project
Create a new project
POST
/
projects
curl --request POST \
--url https://app.planpoint.io/api/projects \
--header 'Authorization: <api-key>'
{
"_id": "objectId",
"user": "objectId",
"floors": [
"objectId"
],
"commercialSpaces": [
"objectId"
],
"name": "<string>",
"websiteURL": "<string>",
"internalURL": "<string>",
"accentColor": "<string>",
"showInclusions": true,
"showBathrooms": true,
"showAdditionalInfo": true,
"showParking": true,
"showOrientation": true,
"brochureButtonEnabled": true,
"brochureAssets": [
"<string>"
],
"customButtonEnabled": true,
"customButtonOpensAt": "same_tab",
"walkscoreEnabled": true,
"walkscore": "<string>",
"customButtonText": "<string>",
"customButtonIcon": "<string>",
"showAvailability": true,
"hideSold": true,
"showPrices": true,
"initialView": "List",
"gtmEnabled": false,
"dayNightEnabled": false,
"showAvailableFirst": false,
"gtmHeadCode": "",
"gtmBodyCode": "",
"unitImageOnGrid": "Unit Plan",
"skipFloorStep": false,
"areaUnit": "<string>",
"showUnitCustomFinishes": false,
"showFloorOverview": false,
"pricesStartingAt": false,
"showPriceFilter": true,
"showAreaFilter": true,
"showUnitDescription": false,
"showTaxes": true,
"sharePageEnabled": true,
"sharePageDescription": "<string>",
"sharePageLogo": "<string>",
"priceBeforeTax": true,
"enableForms": true,
"rentalObject": true,
"deliveryDates": true,
"hideArea": false,
"showBranding": true,
"projectImageUrl": "<string>",
"alternativeCovers": [
"<string>"
],
"customButtonActionType": "url",
"projectSVGUrl": "<string>",
"svgGroupId": "<string>",
"layoutImageUrl": "<string>",
"formsSendTo": "<string>",
"formsSubject": "<string>",
"formsFromName": "<string>",
"formsMessage": "<string>",
"formsRedirectURL": "<string>",
"namespace": "<string>",
"hostName": "<string>",
"projectLang": "<string>",
"projectType": "<string>",
"propertyType": "<string>",
"lotsLayout": "<string>",
"areaDescription": "<string>",
"enterpriseAddressDisplay": "<string>",
"similarSortingBy": "default",
"onHoldExperienceEnabled": false,
"onHoldMinsDuration": 5,
"customFormEnabled": false,
"customFormFields": [],
"crfMessage": "<string>",
"mapLayoutWidth": 123,
"mapLayoutRotation": 123,
"previewMode": false,
"landOnly": false,
"showUnitFinishes": false,
"showVariants": false,
"administrators": [
"objectId"
],
"editors": [
"objectId"
],
"globalAmount": 123,
"chargeType": "same",
"chargeDescription": "",
"chargeCurrency": "usd",
"payButtonText": "Pay Now",
"payButtonIcon": "",
"invites": [
{
"firstName": "<string>",
"lastName": "<string>",
"email": "<string>",
"level": "<string>"
}
],
"leads": [
{
"firstName": "<string>",
"lastName": "<string>",
"email": "<string>",
"phone": "<string>",
"unit": "<string>",
"message": "<string>",
"source": "<string>",
"createdAt": "<string>",
"questions": [
{
"question": "<string>",
"answer": "<string>"
}
],
"customFields": [
{
"key": "<string>",
"value": "<string>"
}
]
}
],
"waitlistees": [
{
"firstName": "<string>",
"lastName": "<string>",
"email": "<string>",
"phone": "<string>",
"unit": "<string>",
"createdAt": "<string>"
}
],
"allocations": [
{
"name": "<string>",
"password": "<string>",
"allocation": "<string>"
}
],
"images": [
"<string>"
],
"finishes": [
"<string>"
],
"customFinishes": {
"name": "<string>",
"options": {
"kitchen": {
"tabs": [
{
"label": "<string>",
"cover": "<string>",
"thumbnail": "<string>"
}
]
},
"bathroom": {
"tabs": [
{
"label": "<string>",
"cover": "<string>",
"thumbnail": "<string>"
}
]
},
"general": {
"tabs": [
{
"label": "<string>",
"cover": "<string>",
"thumbnail": "<string>"
}
]
}
}
},
"sponsorsEnabled": false,
"waitlistEnabled": false,
"sponsors": "<string>",
"layouts": "<string>",
"downloadableAssets": "<string>",
"floorplans": "<string>",
"plan": {},
"path": "<string>",
"alternativePaths": "<string>",
"invertNav": false,
"address": "<string>",
"lon": -93.75940812944683,
"lat": 43.75940812944682,
"zoomLevel": 0,
"perimeter": "<string>",
"markerImageUrl": "<string>",
"targetMarker": "<string>",
"mapStyle": "Light",
"mapPointColor": "<string>",
"mapDirections": false,
"calUsername": "<string>",
"calKey": "<string>",
"payPalClientId": "<string>",
"payPalDeposit": 123,
"payPalCurrency": "<string>",
"yiApiToken": "<string>",
"yiCompanyCode": "<string>",
"yiPropertyCode": "<string>",
"yiStatusMapping": {
"available": "<string>",
"leased": "<string>",
"sold": "<string>",
"unavailable": "<string>",
"reserved": "<string>"
},
"pvUsername": "<string>",
"pvPassword": "<string>",
"pvBuildingName": "<string>",
"zhClientId": "<string>",
"zhAccessToken": "<string>",
"zhClientSecret": "<string>",
"zhOrgId": "<string>",
"srToken": "<string>",
"srBaseUrl": "<string>",
"sfProjectId": "<string>",
"sfKey": "<string>",
"sfSecret": "<string>",
"soProjectId": "<string>",
"soKey": "<string>",
"soSecret": "<string>",
"soDomain": "<string>",
"bsBuildingId": "<string>",
"bsUsername": "<string>",
"bsPassword": "<string>",
"ftpUrl": "<string>",
"ftpPort": 123,
"ftpUsername": "<string>",
"ftpPassword": "<string>",
"ftpWhitelist": "<string>",
"ftpBlacklist": "<string>",
"ftpPath": "<string>",
"ftpFileName": "<string>",
"ftpMapping": [
{
"header": "<string>",
"property": "<string>"
}
],
"colorBase": "<string>",
"colorAccent": "<string>",
"colorHover": "<string>",
"colorButton": "<string>",
"colorButtonText": "<string>",
"colorText": "<string>",
"colorFeatured": "<string>",
"colorSold": "<string>",
"colorAvailable": "<string>",
"colorReserved": "<string>",
"styleNavigation": "<string>",
"styleBranding": "<string>",
"styleFilter": "<string>",
"styleShapes": "<string>",
"styleFont": "<string>",
"subscriptionItem": "<string>",
"lastSync": "<string>",
"lockScreen": false,
"specialRankEnabled": false,
"priorityList": false,
"lockScreenName": true,
"lockScreenEmail": true,
"lockScreenPhone": true,
"lockScreenMessage": true,
"lockScreenCustom": false,
"lockScreenCustomQuestions": [
{
"lang": "<string>",
"value": "<string>"
}
],
"_3dModelUrl": "<string>",
"reportSendTo": "<string>",
"eventsBlockList": "<string>",
"excludeBlockedEvents": true,
"enable3d": false,
"_3dBuildingModelUrl": "<string>",
"_3dFloorSelectorModelUrl": "<string>",
"phasePrefix": "<string>",
"hideGallery": true,
"hideBedrooms": true
}
Authorizations
Query Parameters
Name of the project
Namespace of the project
Hostname of the project
Response
200
application/json
Successful operation
The response is of type object
.
curl --request POST \
--url https://app.planpoint.io/api/projects \
--header 'Authorization: <api-key>'
{
"_id": "objectId",
"user": "objectId",
"floors": [
"objectId"
],
"commercialSpaces": [
"objectId"
],
"name": "<string>",
"websiteURL": "<string>",
"internalURL": "<string>",
"accentColor": "<string>",
"showInclusions": true,
"showBathrooms": true,
"showAdditionalInfo": true,
"showParking": true,
"showOrientation": true,
"brochureButtonEnabled": true,
"brochureAssets": [
"<string>"
],
"customButtonEnabled": true,
"customButtonOpensAt": "same_tab",
"walkscoreEnabled": true,
"walkscore": "<string>",
"customButtonText": "<string>",
"customButtonIcon": "<string>",
"showAvailability": true,
"hideSold": true,
"showPrices": true,
"initialView": "List",
"gtmEnabled": false,
"dayNightEnabled": false,
"showAvailableFirst": false,
"gtmHeadCode": "",
"gtmBodyCode": "",
"unitImageOnGrid": "Unit Plan",
"skipFloorStep": false,
"areaUnit": "<string>",
"showUnitCustomFinishes": false,
"showFloorOverview": false,
"pricesStartingAt": false,
"showPriceFilter": true,
"showAreaFilter": true,
"showUnitDescription": false,
"showTaxes": true,
"sharePageEnabled": true,
"sharePageDescription": "<string>",
"sharePageLogo": "<string>",
"priceBeforeTax": true,
"enableForms": true,
"rentalObject": true,
"deliveryDates": true,
"hideArea": false,
"showBranding": true,
"projectImageUrl": "<string>",
"alternativeCovers": [
"<string>"
],
"customButtonActionType": "url",
"projectSVGUrl": "<string>",
"svgGroupId": "<string>",
"layoutImageUrl": "<string>",
"formsSendTo": "<string>",
"formsSubject": "<string>",
"formsFromName": "<string>",
"formsMessage": "<string>",
"formsRedirectURL": "<string>",
"namespace": "<string>",
"hostName": "<string>",
"projectLang": "<string>",
"projectType": "<string>",
"propertyType": "<string>",
"lotsLayout": "<string>",
"areaDescription": "<string>",
"enterpriseAddressDisplay": "<string>",
"similarSortingBy": "default",
"onHoldExperienceEnabled": false,
"onHoldMinsDuration": 5,
"customFormEnabled": false,
"customFormFields": [],
"crfMessage": "<string>",
"mapLayoutWidth": 123,
"mapLayoutRotation": 123,
"previewMode": false,
"landOnly": false,
"showUnitFinishes": false,
"showVariants": false,
"administrators": [
"objectId"
],
"editors": [
"objectId"
],
"globalAmount": 123,
"chargeType": "same",
"chargeDescription": "",
"chargeCurrency": "usd",
"payButtonText": "Pay Now",
"payButtonIcon": "",
"invites": [
{
"firstName": "<string>",
"lastName": "<string>",
"email": "<string>",
"level": "<string>"
}
],
"leads": [
{
"firstName": "<string>",
"lastName": "<string>",
"email": "<string>",
"phone": "<string>",
"unit": "<string>",
"message": "<string>",
"source": "<string>",
"createdAt": "<string>",
"questions": [
{
"question": "<string>",
"answer": "<string>"
}
],
"customFields": [
{
"key": "<string>",
"value": "<string>"
}
]
}
],
"waitlistees": [
{
"firstName": "<string>",
"lastName": "<string>",
"email": "<string>",
"phone": "<string>",
"unit": "<string>",
"createdAt": "<string>"
}
],
"allocations": [
{
"name": "<string>",
"password": "<string>",
"allocation": "<string>"
}
],
"images": [
"<string>"
],
"finishes": [
"<string>"
],
"customFinishes": {
"name": "<string>",
"options": {
"kitchen": {
"tabs": [
{
"label": "<string>",
"cover": "<string>",
"thumbnail": "<string>"
}
]
},
"bathroom": {
"tabs": [
{
"label": "<string>",
"cover": "<string>",
"thumbnail": "<string>"
}
]
},
"general": {
"tabs": [
{
"label": "<string>",
"cover": "<string>",
"thumbnail": "<string>"
}
]
}
}
},
"sponsorsEnabled": false,
"waitlistEnabled": false,
"sponsors": "<string>",
"layouts": "<string>",
"downloadableAssets": "<string>",
"floorplans": "<string>",
"plan": {},
"path": "<string>",
"alternativePaths": "<string>",
"invertNav": false,
"address": "<string>",
"lon": -93.75940812944683,
"lat": 43.75940812944682,
"zoomLevel": 0,
"perimeter": "<string>",
"markerImageUrl": "<string>",
"targetMarker": "<string>",
"mapStyle": "Light",
"mapPointColor": "<string>",
"mapDirections": false,
"calUsername": "<string>",
"calKey": "<string>",
"payPalClientId": "<string>",
"payPalDeposit": 123,
"payPalCurrency": "<string>",
"yiApiToken": "<string>",
"yiCompanyCode": "<string>",
"yiPropertyCode": "<string>",
"yiStatusMapping": {
"available": "<string>",
"leased": "<string>",
"sold": "<string>",
"unavailable": "<string>",
"reserved": "<string>"
},
"pvUsername": "<string>",
"pvPassword": "<string>",
"pvBuildingName": "<string>",
"zhClientId": "<string>",
"zhAccessToken": "<string>",
"zhClientSecret": "<string>",
"zhOrgId": "<string>",
"srToken": "<string>",
"srBaseUrl": "<string>",
"sfProjectId": "<string>",
"sfKey": "<string>",
"sfSecret": "<string>",
"soProjectId": "<string>",
"soKey": "<string>",
"soSecret": "<string>",
"soDomain": "<string>",
"bsBuildingId": "<string>",
"bsUsername": "<string>",
"bsPassword": "<string>",
"ftpUrl": "<string>",
"ftpPort": 123,
"ftpUsername": "<string>",
"ftpPassword": "<string>",
"ftpWhitelist": "<string>",
"ftpBlacklist": "<string>",
"ftpPath": "<string>",
"ftpFileName": "<string>",
"ftpMapping": [
{
"header": "<string>",
"property": "<string>"
}
],
"colorBase": "<string>",
"colorAccent": "<string>",
"colorHover": "<string>",
"colorButton": "<string>",
"colorButtonText": "<string>",
"colorText": "<string>",
"colorFeatured": "<string>",
"colorSold": "<string>",
"colorAvailable": "<string>",
"colorReserved": "<string>",
"styleNavigation": "<string>",
"styleBranding": "<string>",
"styleFilter": "<string>",
"styleShapes": "<string>",
"styleFont": "<string>",
"subscriptionItem": "<string>",
"lastSync": "<string>",
"lockScreen": false,
"specialRankEnabled": false,
"priorityList": false,
"lockScreenName": true,
"lockScreenEmail": true,
"lockScreenPhone": true,
"lockScreenMessage": true,
"lockScreenCustom": false,
"lockScreenCustomQuestions": [
{
"lang": "<string>",
"value": "<string>"
}
],
"_3dModelUrl": "<string>",
"reportSendTo": "<string>",
"eventsBlockList": "<string>",
"excludeBlockedEvents": true,
"enable3d": false,
"_3dBuildingModelUrl": "<string>",
"_3dFloorSelectorModelUrl": "<string>",
"phasePrefix": "<string>",
"hideGallery": true,
"hideBedrooms": true
}