using RestSharp;
var options = new RestClientOptions("https://sandbox.api.portal.io/zapier/trigger/proposal");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Accept", "<accept>");
request.AddHeader("X-MSS-API-APPID", "<api-key>");
request.AddHeader("X-MSS-API-USERKEY", "<api-key>");
request.AddHeader("X-MSS-CUSTOM-DATE", "<api-key>");
request.AddHeader("X-MSS-SIGNATURE", "<api-key>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
{
"responseStatus": {
"errorCode": "Unauthorized",
"message": "Authentication failed. Verify the HMAC headers and credentials used for the request."
}
}
Zapier Triggers
Zapier Trigger: Proposal Status Change
Zapier trigger that fires when a proposal’s status changes in Portal.io.
using RestSharp;
var options = new RestClientOptions("https://sandbox.api.portal.io/zapier/trigger/proposal");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Accept", "<accept>");
request.AddHeader("X-MSS-API-APPID", "<api-key>");
request.AddHeader("X-MSS-API-USERKEY", "<api-key>");
request.AddHeader("X-MSS-CUSTOM-DATE", "<api-key>");
request.AddHeader("X-MSS-SIGNATURE", "<api-key>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
{
"responseStatus": {
"errorCode": "Unauthorized",
"message": "Authentication failed. Verify the HMAC headers and credentials used for the request."
}
}
This endpoint is used by the Portal.io Zapier integration. It fires when a proposal’s status changes in your Portal.io account — for example, when a proposal moves from Draft to Submitted, or from Submitted to Accepted.Each Zapier subscription can filter by specific statuses so that your Zap only triggers on transitions you care about.
{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"Portal.io API","colors":{"primary":"#FF5000","light":"#FF6B1A","dark":"#FF5000"},"logo":{"light":"https://mintcdn.com/portalio/QuSRLNwghuEPmEf4/logo-files/portal-logo-light.svg?fit=max\u0026auto=format\u0026n=QuSRLNwghuEPmEf4\u0026q=85\u0026s=b46857228d074b069b086559f1b032ab","dark":"https://mintcdn.com/portalio/QuSRLNwghuEPmEf4/logo-files/portal-logo-light.svg?fit=max\u0026auto=format\u0026n=QuSRLNwghuEPmEf4\u0026q=85\u0026s=b46857228d074b069b086559f1b032ab"},"favicon":"https://mintcdn.com/portalio/NuVzj4dQjIlaNLdz/favicon.svg?fit=max\u0026auto=format\u0026n=NuVzj4dQjIlaNLdz\u0026q=85\u0026s=98ab85efdca173dc9b3f2334c2437758","api":{"openapi":"public.json","playground":{"display":"interactive"},"examples":{"defaults":"all","languages":["bash","python","javascript","java","csharp"],"prefill":true}},"navbar":{"links":[],"primary":{"type":"button","label":"Contact Us","href":"https://portal.canny.io/developer-api"}},"fonts":{"heading":{"family":"Open Sans"},"body":{"family":"Open Sans"}},"contextual":{"options":["copy","view","claude","chatgpt","cursor","vscode","mcp"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"portalio","hasAudioNarration":false,"actualSubdomain":"portalio","customDomains":["docs.portal.io"],"gitSource":{"type":"github","owner":"portalio","repo":"api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad0dd3033278c5ac967f16f","collectionId":"ca37ba77-4a76-4cf1-a1b3-003273d4b6c0","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad0dd3033278c5ac967f16f"},"entitlements":{"AI_CHAT":{"status":"ENABLED"}},"buildId":"6ad0dd3033278c5ac967f16f","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"API Reference","count":59},{"language":"default","tag":"Proposal Items","count":19},{"language":"default","tag":"Guide","count":13},{"language":"default","tag":"Proposals","count":12},{"language":"default","tag":"AI Builder","count":6},{"language":"default","tag":"Pricing","count":6},{"language":"default","tag":"Concepts","count":6},{"language":"default","tag":"Get Started","count":5},{"language":"default","tag":"People","count":5},{"language":"default","tag":"Webhooks","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@portal.io","showHelpButton":true}},"hasChatPermissions":true,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":".sidebar-group-header,.sidebar-group-header h5#sidebar-title{text-transform:uppercase!important;letter-spacing:.05em!important}"}],"page":{"pagePath":"api-reference/zapier-triggers/proposal-status-change","slug":"/api-reference/zapier-triggers/proposal-status-change","pageMetadata":{"title":"Zapier Trigger: Proposal Status Change","description":"Zapier trigger that fires when a proposal's status changes in Portal.io.","openapi":"GET /zapier/trigger/proposal","href":"/api-reference/zapier-triggers/proposal-status-change"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Zapier trigger that fires when a proposal’s status changes in Portal.io.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,..._provideComponents(),...props.components};return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`This endpoint is used by the Portal.io Zapier integration. It fires when a proposal’s status changes in your Portal.io account — for example, when a proposal moves from Draft to Submitted, or from Submitted to Accepted.`}),`\n`,_jsx(_components.p,{children:`Each Zapier subscription can filter by specific statuses so that your Zap only triggers on transitions you care about.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Zapier Trigger: Proposal Status Change","description":"Zapier trigger that fires when a proposal's status changes in Portal.io.","openapi":"GET /zapier/trigger/proposal","href":"/api-reference/zapier-triggers/proposal-status-change"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Zapier Triggers"],"summary":"Zapier Trigger for Proposal Status Change","description":"Zapier trigger that fires when a proposal's status changes in Portal.io.","operationId":"getZapierTriggerProposal","parameters":["7d7096f2-3a5d-4af3-8f12-17118074fb58"],"responses":{"200":"b010dafa-7076-429c-a1ae-573d43c5a8aa","401":"e70187c5-8012-49aa-bcd7-c2670c2b5544"},"method":"get","type":"path","servers":["2356a69a-1607-441f-8551-a7d818f04601"],"security":["a4e71cdc-024b-4a55-a108-51853ac6eb53"],"path":"/zapier/trigger/proposal","baseUrlOptions":["https://sandbox.api.portal.io/"],"title":"Zapier Trigger for Proposal Status Change","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","java","csharp"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[]},"dependencies":{"parameters":{"7d7096f2-3a5d-4af3-8f12-17118074fb58":{"name":"Accept","in":"header","description":"Accept Header","required":true,"schema":{"type":"string","x-default":"application/json","isRequired":true,"description":"Accept Header","uniqueKey":"","typeLabel":"string"}}},"responses":{"b010dafa-7076-429c-a1ae-573d43c5a8aa":{"description":"Proposal List.","content":{"application/json":{"schema":{"type":"object","title":"ZapierProposalItem","description":"ZapierProposalItem","required":["id"],"properties":{"id":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"id","typeLabel":"integer\u003cint32>"},"name":{"type":"string","uniqueKey":"name","typeLabel":"string"},"number":{"type":"integer","format":"int32","uniqueKey":"number","typeLabel":"integer\u003cint32>"},"status":{"enum":["Undefined","Draft","Submitted","ViewedByClient","Accepted","Declined","Delayed","Completed","EmailFailed","Expired"],"type":"string","uniqueKey":"status","typeLabel":"enum\u003cstring>"},"total":{"oneOf":[{"type":"null","format":"double","uniqueKey":"total.oneOf.0","typeLabel":"null"},{"type":"number","format":"double","uniqueKey":"total.oneOf.1","typeLabel":"number\u003cdouble>"}],"uniqueKey":"total","typeLabel":"null | number\u003cdouble>"},"customer":{"type":"object","title":"PublicCustomerModel","description":"Customer contact","required":["id"],"properties":{"id":{"type":"integer","description":"Unique numeric identifier of the contact","format":"int32","isRequired":true,"uniqueKey":"customer.id","typeLabel":"integer\u003cint32>"},"partyType":{"type":"string","enum":["Undefined","Person","Company"],"uniqueKey":"customer.partyType","typeLabel":"enum\u003cstring>"},"contactType":{"type":"string","enum":["Undefined","Client","Employee","Contractor","Other","Vendor","Subcontractor","Designer","GeneralContractor"],"uniqueKey":"customer.contactType","typeLabel":"enum\u003cstring>"},"firstName":{"type":"string","description":"Contact first name","uniqueKey":"customer.firstName","typeLabel":"string"},"lastName":{"type":"string","description":"Contact last name","uniqueKey":"customer.lastName","typeLabel":"string"},"companyName":{"type":"string","description":"Company name when the contact represents a company","uniqueKey":"customer.companyName","typeLabel":"string"},"contactEmail":{"type":"string","description":"Primary contact email address","uniqueKey":"customer.contactEmail","typeLabel":"string"},"contactEmailCC":{"type":"string","description":"Additional email addresses copied when a proposal is submitted","uniqueKey":"customer.contactEmailCC","typeLabel":"string"},"contactPhone":{"type":"string","description":"Primary contact phone number","uniqueKey":"customer.contactPhone","typeLabel":"string"},"location":{"title":"PublicLocationModel","type":"object","properties":{"id":{"type":"integer","description":"Unique numeric identifier of the location, when available.","format":"int32","uniqueKey":"customer.location.id","typeLabel":"integer\u003cint32>"},"street":{"type":"string","description":"Primary street address line.","uniqueKey":"customer.location.street","typeLabel":"string"},"suite":{"type":"string","description":"Secondary address line, apartment, or suite.","uniqueKey":"customer.location.suite","typeLabel":"string"},"city":{"type":"string","description":"City or locality.","uniqueKey":"customer.location.city","typeLabel":"string"},"postalCode":{"type":"string","description":"Postal or ZIP code.","uniqueKey":"customer.location.postalCode","typeLabel":"string"},"state":{"type":"string","description":"State, province, or region name.","uniqueKey":"customer.location.state","typeLabel":"string"},"stateAbbrev":{"type":"string","description":"State or province abbreviation when available.","uniqueKey":"customer.location.stateAbbrev","typeLabel":"string"},"country":{"type":"string","description":"Country name.","uniqueKey":"customer.location.country","typeLabel":"string"},"phone":{"type":"string","description":"Location phone number when one is associated with this address.","uniqueKey":"customer.location.phone","typeLabel":"string"}},"description":"Location and address details.","uniqueKey":"customer.location","typeLabel":"PublicLocationModel · object"}},"uniqueKey":"customer","typeLabel":"PublicCustomerModel · object"},"proposalPdf":{"oneOf":[{"type":"null","uniqueKey":"proposalPdf.oneOf.0","typeLabel":"null"},{"type":"string","uniqueKey":"proposalPdf.oneOf.1","typeLabel":"string"}],"uniqueKey":"proposalPdf","typeLabel":"null | string"},"proposalCsv":{"oneOf":[{"type":"null","uniqueKey":"proposalCsv.oneOf.0","typeLabel":"null"},{"type":"string","uniqueKey":"proposalCsv.oneOf.1","typeLabel":"string"}],"uniqueKey":"proposalCsv","typeLabel":"null | string"},"installerPdf":{"oneOf":[{"type":"null","uniqueKey":"installerPdf.oneOf.0","typeLabel":"null"},{"type":"string","uniqueKey":"installerPdf.oneOf.1","typeLabel":"string"}],"uniqueKey":"installerPdf","typeLabel":"null | string"},"salesPerson":{"oneOf":[{"type":"null","uniqueKey":"salesPerson.oneOf.0","typeLabel":"null"},{"type":"string","uniqueKey":"salesPerson.oneOf.1","typeLabel":"string"}],"uniqueKey":"salesPerson","typeLabel":"null | string"},"salesPersonEmail":{"oneOf":[{"type":"null","uniqueKey":"salesPersonEmail.oneOf.0","typeLabel":"null"},{"type":"string","uniqueKey":"salesPersonEmail.oneOf.1","typeLabel":"string"}],"uniqueKey":"salesPersonEmail","typeLabel":"null | string"},"areas":{"type":"array","items":{"title":"PublicAreaModel","required":["id","name","options"],"type":"object","properties":{"id":{"type":"integer","description":"Unique numeric identifier of the proposal area","format":"int32","isRequired":true,"uniqueKey":"areas.items.[INDEX].id","typeLabel":"integer\u003cint32>"},"name":{"type":"string","description":"Area name","isRequired":true,"uniqueKey":"areas.items.[INDEX].name","typeLabel":"string"},"options":{"type":"array","items":{"title":"PublicAreaOptionModel","required":["id","lastModifiedDate","total","totalRecurringService"],"type":"object","properties":{"id":{"type":"integer","description":"Unique numeric identifier of the proposal area option","format":"int32","isRequired":true,"uniqueKey":"areas.items.[INDEX].options.items.[INDEX].id","typeLabel":"integer\u003cint32>"},"lastModifiedDate":{"type":"string","description":"UTC timestamp when the option was last modified","format":"date-time","isRequired":true,"uniqueKey":"areas.items.[INDEX].options.items.[INDEX].lastModifiedDate","typeLabel":"string\u003cdate-time>"},"total":{"type":"number","description":"Total amount for the option","format":"double","isRequired":true,"uniqueKey":"areas.items.[INDEX].options.items.[INDEX].total","typeLabel":"number\u003cdouble>"},"totalRecurringService":{"type":"number","description":"Recurring-service total for the option","format":"double","isRequired":true,"uniqueKey":"areas.items.[INDEX].options.items.[INDEX].totalRecurringService","typeLabel":"number\u003cdouble>"},"status":{"enum":["Draft","Accepted","Declined"],"type":"string","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"clientDescription":{"type":"string","description":"Client-facing option description","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].clientDescription","typeLabel":"string"},"installerDescription":{"type":"string","description":"Installer-facing option description","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].installerDescription","typeLabel":"string"},"items":{"type":"array","items":{"title":"PublicAreaItemModel","required":["id","referencedItemId","createdDate","quantity"],"type":"object","properties":{"id":{"type":"integer","description":"Unique numeric identifier of the proposal item","format":"int32","isRequired":true,"uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].id","typeLabel":"integer\u003cint32>"},"referencedItemId":{"type":"integer","description":"Identifier of the catalog, labor, custom, or fee item this proposal item was created from","format":"int32","isRequired":true,"uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].referencedItemId","typeLabel":"integer\u003cint32>"},"createdDate":{"type":"string","description":"UTC timestamp when the proposal item was created","format":"date-time","isRequired":true,"uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].createdDate","typeLabel":"string\u003cdate-time>"},"quantity":{"type":"number","description":"Quantity of the proposal item","format":"double","isRequired":true,"uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].quantity","typeLabel":"number\u003cdouble>"},"parentId":{"type":"integer","description":"Identifier of the parent item when this item is nested under another item","format":"int32","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].parentId","typeLabel":"integer\u003cint32>"},"itemType":{"enum":["Part","Labor","CustomItem","Fee"],"type":"string","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].itemType","typeLabel":"enum\u003cstring>"},"lastModifiedDate":{"type":"string","description":"UTC timestamp when the proposal item was last modified","format":"date-time","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].lastModifiedDate","typeLabel":"string\u003cdate-time>"},"brand":{"type":"string","description":"Brand name of the item","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].brand","typeLabel":"string"},"model":{"type":"string","description":"Model value of the item","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].model","typeLabel":"string"},"name":{"type":"string","description":"Name of a Labor item","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].name","typeLabel":"string"},"shortDescription":{"type":"string","description":"Short description shown for the proposal item","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].shortDescription","typeLabel":"string"},"clientNote":{"type":"string","description":"Client-facing note for the proposal item","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].clientNote","typeLabel":"string"},"imageUrl":{"type":"string","description":"Image URL of the item","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].imageUrl","typeLabel":"string"},"msrp":{"type":"number","description":"MSRP amount of the item","format":"double","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].msrp","typeLabel":"number\u003cdouble>"},"sellPrice":{"type":"number","description":"Sell price for the proposal item","format":"double","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].sellPrice","typeLabel":"number\u003cdouble>"},"cost":{"type":"number","description":"Supplier cost for the proposal item","format":"double","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].cost","typeLabel":"number\u003cdouble>"},"costUpdateDate":{"type":"string","description":"UTC timestamp when the supplier cost was last updated","format":"date-time","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].costUpdateDate","typeLabel":"string\u003cdate-time>"},"supplier":{"type":"string","description":"Display name of the supplier assigned to the item.","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].supplier","typeLabel":"string"},"total":{"title":"PublicItemTotalModel","required":["amount"],"type":"object","properties":{"amount":{"type":"number","description":"Per-unit sell price multiplied by quantity, before tax","format":"double","isRequired":true,"uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].total.amount","typeLabel":"number\u003cdouble>"},"currency":{"title":"PublicCurrencyModel","required":["code","symbol"],"type":"object","properties":{"code":{"type":"string","description":"ISO 4217 code that identifies the currency used for the amount.","isRequired":true,"uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].total.currency.code","typeLabel":"string"},"symbol":{"type":"string","description":"Symbol displayed alongside monetary values in this currency.","isRequired":true,"uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].total.currency.symbol","typeLabel":"string"}},"description":"Currency code and symbol used to display money values.","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].total.currency","typeLabel":"PublicCurrencyModel · object"},"isCombinedPrice":{"type":"boolean","description":"Whether the totals of nested items are included in this item's amount","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].total.isCombinedPrice","typeLabel":"boolean"}},"description":"Total amount for a proposal item","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].total","typeLabel":"PublicItemTotalModel · object"},"isTaxExempt":{"type":"boolean","description":"Whether the proposal item is tax exempt","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].isTaxExempt","typeLabel":"boolean"},"isRecurringService":{"type":"boolean","description":"Whether the proposal item is a recurring service","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].isRecurringService","typeLabel":"boolean"},"linkedOrders":{"type":"array","items":{"title":"PublicLinkedOrderModel","required":["orderId","orderNumber","orderNumberSuffix","orderName"],"type":"object","properties":{"orderId":{"type":"integer","description":"Unique numeric identifier of the order","format":"int32","isRequired":true,"uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].linkedOrders.items.[INDEX].orderId","typeLabel":"integer\u003cint32>"},"orderNumber":{"type":"integer","description":"Order number shown to the dealer","format":"int32","isRequired":true,"uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].linkedOrders.items.[INDEX].orderNumber","typeLabel":"integer\u003cint32>"},"orderNumberSuffix":{"type":"string","description":"Order number suffix used for supplier-specific numbering","isRequired":true,"uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].linkedOrders.items.[INDEX].orderNumberSuffix","typeLabel":"string"},"orderName":{"type":"string","description":"Display name of the order","isRequired":true,"uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].linkedOrders.items.[INDEX].orderName","typeLabel":"string"},"supplier":{"type":"string","description":"Supplier display name","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].linkedOrders.items.[INDEX].supplier","typeLabel":"string"},"supplierRef":{"type":"string","description":"Supplier reference or supplier order number","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].linkedOrders.items.[INDEX].supplierRef","typeLabel":"string"},"orderStatus":{"enum":["Draft","Submitted","ViewedBySupplier","Accepted","Received","EmailFailed","Undefined"],"type":"string","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].linkedOrders.items.[INDEX].orderStatus","typeLabel":"enum\u003cstring>"}},"description":"Order summary linked to a proposal item","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].linkedOrders.items.[INDEX]","typeLabel":"PublicLinkedOrderModel · object"},"description":"Linked orders created from this proposal item","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX].linkedOrders","typeLabel":"PublicLinkedOrderModel · object[]"}},"description":"Proposal area item","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items.items.[INDEX]","typeLabel":"PublicAreaItemModel · object"},"description":"Items included in the option","uniqueKey":"areas.items.[INDEX].options.items.[INDEX].\\items","typeLabel":"PublicAreaItemModel · object[]"}},"description":"Area option","uniqueKey":"areas.items.[INDEX].options.items.[INDEX]","typeLabel":"PublicAreaOptionModel · object"},"description":"Client-selectable options available within the area","isRequired":true,"uniqueKey":"areas.items.[INDEX].options","typeLabel":"PublicAreaOptionModel · object[]"}},"description":"Proposal area","uniqueKey":"areas.items.[INDEX]","typeLabel":"PublicAreaModel · object"},"uniqueKey":"areas","typeLabel":"PublicAreaModel · object[]"},"financialSummary":{"type":"object","title":"PublicFinancialSummaryModel","description":"Financial totals, discounts, tax, and currency values for the proposal","required":["partsSubtotal","partsTotal","laborTotal","feeTotal","proposalSubtotal"],"properties":{"partsSubtotal":{"type":"number","description":"Total of all sell prices for parts on proposal, before any additional discount","format":"double","isRequired":true,"uniqueKey":"financialSummary.partsSubtotal","typeLabel":"number\u003cdouble>"},"partsTotal":{"type":"number","description":"Total of all sell prices for parts on proposal, after additional discount","format":"double","isRequired":true,"uniqueKey":"financialSummary.partsTotal","typeLabel":"number\u003cdouble>"},"laborTotal":{"type":"number","description":"Total sell price of labor items on the proposal","format":"double","isRequired":true,"uniqueKey":"financialSummary.laborTotal","typeLabel":"number\u003cdouble>"},"feeTotal":{"type":"number","description":"Total sell price of fee items on the proposal","format":"double","isRequired":true,"uniqueKey":"financialSummary.feeTotal","typeLabel":"number\u003cdouble>"},"proposalSubtotal":{"type":"number","description":"Sum of parts, labor, and fees before sales tax","format":"double","isRequired":true,"uniqueKey":"financialSummary.proposalSubtotal","typeLabel":"number\u003cdouble>"},"proposalTotal":{"type":"number","description":"Total proposal amount","format":"double","uniqueKey":"financialSummary.proposalTotal","typeLabel":"number\u003cdouble>"},"currency":{"type":"object","title":"PublicCurrencyModel","description":"Currency code and symbol used to display money values.","required":["code","symbol"],"properties":{"code":{"type":"string","description":"ISO 4217 code that identifies the currency used for the amount.","isRequired":true,"uniqueKey":"financialSummary.currency.code","typeLabel":"string"},"symbol":{"type":"string","description":"Symbol displayed alongside monetary values in this currency.","isRequired":true,"uniqueKey":"financialSummary.currency.symbol","typeLabel":"string"}},"uniqueKey":"financialSummary.currency","typeLabel":"PublicCurrencyModel · object"},"partsDiscountType":{"enum":["Percentage","Fixed"],"type":"string","uniqueKey":"financialSummary.partsDiscountType","typeLabel":"enum\u003cstring>"},"partsDiscountPercentage":{"type":"number","description":"Parts discount percentage when one exists","format":"double","uniqueKey":"financialSummary.partsDiscountPercentage","typeLabel":"number\u003cdouble>"},"partsDiscount":{"type":"number","description":"Additional discount on parts","format":"double","uniqueKey":"financialSummary.partsDiscount","typeLabel":"number\u003cdouble>"},"partsDiscountTaxable":{"type":"number","description":"Additional discount on taxable parts","format":"double","uniqueKey":"financialSummary.partsDiscountTaxable","typeLabel":"number\u003cdouble>"},"partsDiscountTaxExempt":{"type":"number","description":"Additional discount on tax exempt parts","format":"double","uniqueKey":"financialSummary.partsDiscountTaxExempt","typeLabel":"number\u003cdouble>"},"salesTax":{"title":"PublicSalesTaxModel","type":"object","properties":{"taxStatus":{"enum":["Undefined","Ok","NoState","OutOfCountry","NoClient","NoClientAddress","IncompleteClientAddress","NoCompanyAddress","TaxableStateDeclined"],"type":"string","uniqueKey":"financialSummary.salesTax.taxStatus","typeLabel":"enum\u003cstring>"},"total":{"type":"number","description":"Total sales-tax amount","format":"double","uniqueKey":"financialSummary.salesTax.total","typeLabel":"number\u003cdouble>"},"calculation":{"title":"PublicTaxCalculationModel","required":["hasMultipleTaxSupport","isTaxJarAvailable"],"type":"object","properties":{"hasMultipleTaxSupport":{"type":"boolean","description":"Whether multiple tax lines are supported","isRequired":true,"uniqueKey":"financialSummary.salesTax.calculation.hasMultipleTaxSupport","typeLabel":"boolean"},"isTaxJarAvailable":{"type":"boolean","description":"Whether TaxJar is available for this calculation","isRequired":true,"uniqueKey":"financialSummary.salesTax.calculation.isTaxJarAvailable","typeLabel":"boolean"},"method":{"enum":["ClientLocation","CompanyLocation","FixedPercentage","None"],"type":"string","uniqueKey":"financialSummary.salesTax.calculation.method","typeLabel":"enum\u003cstring>"},"applyTo":{"type":"array","items":{"enum":["Parts","Labor","Fee"],"type":"string","uniqueKey":"financialSummary.salesTax.calculation.applyTo.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"financialSummary.salesTax.calculation.applyTo","typeLabel":"enum\u003cstring>[]"},"partsTax":{"type":"number","description":"Primary parts tax rate or amount","format":"double","uniqueKey":"financialSummary.salesTax.calculation.partsTax","typeLabel":"number\u003cdouble>"},"partsTaxName":{"type":"string","description":"Display name for the primary parts tax","uniqueKey":"financialSummary.salesTax.calculation.partsTaxName","typeLabel":"string"},"laborTax":{"type":"number","description":"Primary labor tax rate or amount","format":"double","uniqueKey":"financialSummary.salesTax.calculation.laborTax","typeLabel":"number\u003cdouble>"},"laborTaxName":{"type":"string","description":"Display name for the primary labor tax","uniqueKey":"financialSummary.salesTax.calculation.laborTaxName","typeLabel":"string"},"partsTax2":{"type":"number","description":"Secondary parts tax rate or amount when multiple tax support is enabled","format":"double","uniqueKey":"financialSummary.salesTax.calculation.partsTax2","typeLabel":"number\u003cdouble>"},"partsTax2Name":{"type":"string","description":"Display name for the secondary parts tax","uniqueKey":"financialSummary.salesTax.calculation.partsTax2Name","typeLabel":"string"},"laborTax2":{"type":"number","description":"Secondary labor tax rate or amount when multiple tax support is enabled","format":"double","uniqueKey":"financialSummary.salesTax.calculation.laborTax2","typeLabel":"number\u003cdouble>"},"laborTax2Name":{"type":"string","description":"Display name for the secondary labor tax","uniqueKey":"financialSummary.salesTax.calculation.laborTax2Name","typeLabel":"string"},"feeTax":{"type":"number","description":"Primary fee tax rate or amount","format":"double","uniqueKey":"financialSummary.salesTax.calculation.feeTax","typeLabel":"number\u003cdouble>"},"feeTaxName":{"type":"string","description":"Display name for the primary fee tax","uniqueKey":"financialSummary.salesTax.calculation.feeTaxName","typeLabel":"string"},"feeTax2":{"type":"number","description":"Secondary fee tax rate or amount when multiple tax support is enabled","format":"double","uniqueKey":"financialSummary.salesTax.calculation.feeTax2","typeLabel":"number\u003cdouble>"},"feeTax2Name":{"type":"string","description":"Display name for the secondary fee tax","uniqueKey":"financialSummary.salesTax.calculation.feeTax2Name","typeLabel":"string"},"taxLocation":{"title":"PublicLocationModel","type":"object","properties":{"id":{"type":"integer","description":"Unique numeric identifier of the location, when available.","format":"int32","uniqueKey":"financialSummary.salesTax.calculation.taxLocation.id","typeLabel":"integer\u003cint32>"},"street":{"type":"string","description":"Primary street address line.","uniqueKey":"financialSummary.salesTax.calculation.taxLocation.street","typeLabel":"string"},"suite":{"type":"string","description":"Secondary address line, apartment, or suite.","uniqueKey":"financialSummary.salesTax.calculation.taxLocation.suite","typeLabel":"string"},"city":{"type":"string","description":"City or locality.","uniqueKey":"financialSummary.salesTax.calculation.taxLocation.city","typeLabel":"string"},"postalCode":{"type":"string","description":"Postal or ZIP code.","uniqueKey":"financialSummary.salesTax.calculation.taxLocation.postalCode","typeLabel":"string"},"state":{"type":"string","description":"State, province, or region name.","uniqueKey":"financialSummary.salesTax.calculation.taxLocation.state","typeLabel":"string"},"stateAbbrev":{"type":"string","description":"State or province abbreviation when available.","uniqueKey":"financialSummary.salesTax.calculation.taxLocation.stateAbbrev","typeLabel":"string"},"country":{"type":"string","description":"Country name.","uniqueKey":"financialSummary.salesTax.calculation.taxLocation.country","typeLabel":"string"},"phone":{"type":"string","description":"Location phone number when one is associated with this address.","uniqueKey":"financialSummary.salesTax.calculation.taxLocation.phone","typeLabel":"string"}},"description":"Location and address details.","uniqueKey":"financialSummary.salesTax.calculation.taxLocation","typeLabel":"PublicLocationModel · object"},"partsTotalTax":{"type":"number","description":"Total tax amount applied to parts","format":"double","uniqueKey":"financialSummary.salesTax.calculation.partsTotalTax","typeLabel":"number\u003cdouble>"},"laborTotalTax":{"type":"number","description":"Total tax amount applied to labor","format":"double","uniqueKey":"financialSummary.salesTax.calculation.laborTotalTax","typeLabel":"number\u003cdouble>"},"feeTotalTax":{"type":"number","description":"Total tax amount applied to fees","format":"double","uniqueKey":"financialSummary.salesTax.calculation.feeTotalTax","typeLabel":"number\u003cdouble>"}},"description":"Tax calculation details","uniqueKey":"financialSummary.salesTax.calculation","typeLabel":"PublicTaxCalculationModel · object"}},"description":"Sales-tax summary","uniqueKey":"financialSummary.salesTax","typeLabel":"PublicSalesTaxModel · object"}},"uniqueKey":"financialSummary","typeLabel":"PublicFinancialSummaryModel · object"},"profit":{"title":"PublicProfitModel","type":"object","properties":{"total":{"type":"number","description":"Total profit amount for the proposal","format":"double","uniqueKey":"profit.total","typeLabel":"number\u003cdouble>"},"percentage":{"type":"number","description":"Total profit margin percentage for the proposal","format":"double","uniqueKey":"profit.percentage","typeLabel":"number\u003cdouble>"},"partTotal":{"type":"number","description":"Profit amount contributed by parts","format":"double","uniqueKey":"profit.partTotal","typeLabel":"number\u003cdouble>"},"partPercentage":{"type":"number","description":"Profit margin percentage for parts","format":"double","uniqueKey":"profit.partPercentage","typeLabel":"number\u003cdouble>"},"laborTotal":{"type":"number","description":"Profit amount contributed by labor","format":"double","uniqueKey":"profit.laborTotal","typeLabel":"number\u003cdouble>"},"laborPercentage":{"type":"number","description":"Profit margin percentage for labor","format":"double","uniqueKey":"profit.laborPercentage","typeLabel":"number\u003cdouble>"},"isProfitIncludeCos":{"type":"boolean","description":"Whether change orders are included in the profit calculation","uniqueKey":"profit.isProfitIncludeCos","typeLabel":"boolean"}},"description":"Profit summary for the proposal","uniqueKey":"profit","typeLabel":"PublicProfitModel · object"},"recurringServices":{"title":"PublicRecurringServicesModel","required":["items","totalRecurringService"],"type":"object","properties":{"items":{"type":"array","items":{"title":"PublicRecurringServiceItemModel","required":["name","sellPrice","quantity","totalSell"],"type":"object","properties":{"name":{"type":"string","description":"Recurring service name","isRequired":true,"uniqueKey":"recurringServices.\\items.items.[INDEX].name","typeLabel":"string"},"sellPrice":{"type":"number","description":"Recurring service sell price","format":"double","isRequired":true,"uniqueKey":"recurringServices.\\items.items.[INDEX].sellPrice","typeLabel":"number\u003cdouble>"},"quantity":{"type":"number","description":"Recurring service quantity","format":"double","isRequired":true,"uniqueKey":"recurringServices.\\items.items.[INDEX].quantity","typeLabel":"number\u003cdouble>"},"totalSell":{"type":"number","description":"Recurring service total amount","format":"double","isRequired":true,"uniqueKey":"recurringServices.\\items.items.[INDEX].totalSell","typeLabel":"number\u003cdouble>"}},"description":"Recurring service line item","uniqueKey":"recurringServices.\\items.items.[INDEX]","typeLabel":"PublicRecurringServiceItemModel · object"},"description":"Recurring service line items included with the proposal.","isRequired":true,"uniqueKey":"recurringServices.\\items","typeLabel":"PublicRecurringServiceItemModel · object[]"},"totalRecurringService":{"type":"number","description":"Sum of recurring services on proposal. Not part of the one-time proposal total.","format":"double","isRequired":true,"uniqueKey":"recurringServices.totalRecurringService","typeLabel":"number\u003cdouble>"}},"description":"Recurring service summary associated with the proposal.","uniqueKey":"recurringServices","typeLabel":"PublicRecurringServicesModel · object"},"changeOrders":{"type":"array","items":{"title":"PublicChangeOrderModel","required":["id","number","name","createdDate","lastModifiedDate"],"type":"object","properties":{"id":{"type":"integer","description":"Unique numeric identifier of the change order","format":"int32","isRequired":true,"uniqueKey":"changeOrders.items.[INDEX].id","typeLabel":"integer\u003cint32>"},"number":{"type":"integer","description":"Change-order number shown to the dealer in the UI","format":"int32","isRequired":true,"uniqueKey":"changeOrders.items.[INDEX].number","typeLabel":"integer\u003cint32>"},"name":{"type":"string","description":"Display name of the change order","isRequired":true,"uniqueKey":"changeOrders.items.[INDEX].name","typeLabel":"string"},"createdDate":{"type":"string","description":"UTC timestamp when the change order was created","format":"date-time","isRequired":true,"uniqueKey":"changeOrders.items.[INDEX].createdDate","typeLabel":"string\u003cdate-time>"},"lastModifiedDate":{"type":"string","description":"UTC timestamp when the change order was last modified by the system or a user","format":"date-time","isRequired":true,"uniqueKey":"changeOrders.items.[INDEX].lastModifiedDate","typeLabel":"string\u003cdate-time>"},"status":{"enum":["Undefined","Draft","Submitted","ViewedByClient","Accepted","Declined","Delayed","Completed","EmailFailed","Expired"],"type":"string","uniqueKey":"changeOrders.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"total":{"title":"PublicChangeOrderTotalModel","type":"object","properties":{"changeOrderTotal":{"type":"number","description":"Total change-order amount","format":"double","uniqueKey":"changeOrders.items.[INDEX].total.changeOrderTotal","typeLabel":"number\u003cdouble>"},"currency":{"title":"PublicCurrencyModel","required":["code","symbol"],"type":"object","properties":{"code":{"type":"string","description":"ISO 4217 code that identifies the currency used for the amount.","isRequired":true,"uniqueKey":"changeOrders.items.[INDEX].total.currency.code","typeLabel":"string"},"symbol":{"type":"string","description":"Symbol displayed alongside monetary values in this currency.","isRequired":true,"uniqueKey":"changeOrders.items.[INDEX].total.currency.symbol","typeLabel":"string"}},"description":"Currency code and symbol used to display money values.","uniqueKey":"changeOrders.items.[INDEX].total.currency","typeLabel":"PublicCurrencyModel · object"}},"description":"Change-order total amount and currency","uniqueKey":"changeOrders.items.[INDEX].total","typeLabel":"PublicChangeOrderTotalModel · object"},"customer":{"title":"PublicContactModel","required":["id"],"type":"object","properties":{"id":{"type":"integer","description":"Unique numeric identifier of the contact","format":"int32","isRequired":true,"uniqueKey":"changeOrders.items.[INDEX].customer.id","typeLabel":"integer\u003cint32>"},"partyType":{"enum":["Undefined","Person","Company"],"type":"string","uniqueKey":"changeOrders.items.[INDEX].customer.partyType","typeLabel":"enum\u003cstring>"},"contactType":{"enum":["Undefined","Client","Employee","Contractor","Other","Vendor","Subcontractor","Designer","GeneralContractor"],"type":"string","uniqueKey":"changeOrders.items.[INDEX].customer.contactType","typeLabel":"enum\u003cstring>"},"firstName":{"type":"string","description":"Contact first name","uniqueKey":"changeOrders.items.[INDEX].customer.firstName","typeLabel":"string"},"lastName":{"type":"string","description":"Contact last name","uniqueKey":"changeOrders.items.[INDEX].customer.lastName","typeLabel":"string"},"companyName":{"type":"string","description":"Company name when the contact represents a company","uniqueKey":"changeOrders.items.[INDEX].customer.companyName","typeLabel":"string"},"contactEmail":{"type":"string","description":"Primary contact email address","uniqueKey":"changeOrders.items.[INDEX].customer.contactEmail","typeLabel":"string"},"contactEmailCC":{"type":"string","description":"Additional email addresses copied when a proposal is submitted","uniqueKey":"changeOrders.items.[INDEX].customer.contactEmailCC","typeLabel":"string"},"contactPhone":{"type":"string","description":"Primary contact phone number","uniqueKey":"changeOrders.items.[INDEX].customer.contactPhone","typeLabel":"string"}},"description":"Contact summary model","uniqueKey":"changeOrders.items.[INDEX].customer","typeLabel":"PublicContactModel · object"},"lastModifiedByUserDate":{"type":"string","description":"UTC timestamp when the change order was last modified by a user action","format":"date-time","uniqueKey":"changeOrders.items.[INDEX].lastModifiedByUserDate","typeLabel":"string\u003cdate-time>"}},"description":"Change-order summary","uniqueKey":"changeOrders.items.[INDEX]","typeLabel":"PublicChangeOrderModel · object"},"uniqueKey":"changeOrders","typeLabel":"PublicChangeOrderModel · object[]"}},"uniqueKey":"","typeLabel":"ZapierProposalItem · object"},"example":{"number":936,"status":"Draft","total":796.45,"customer":{"location":{"id":81376,"street":"456 Oak Ave","suite":"Suite 200","city":"Austin","postalCode":"78702","state":"Texas","stateAbbrev":"TX","country":"United States","phone":"555-555-0142"},"id":81376,"partyType":"Person","contactType":"Client","firstName":"Jane","lastName":"Smith","companyName":"AV Solutions Inc.","contactEmail":"jane.smith@example.com","contactEmailCC":"billing@example.com","contactPhone":"555-555-0100"},"proposalPdf":"https://files.portal.io/proposals/1042.pdf","proposalCsv":"https://files.portal.io/proposals/1042.csv","installerPdf":"https://files.portal.io/proposals/1042-installer.pdf","salesPerson":"Alex Johnson","salesPersonEmail":"alex.johnson@example.com","areas":[{"id":81376,"name":"Living Room","options":[{"id":81376,"status":"Draft","lastModifiedDate":"2031-02-06T00:22:19Z","clientDescription":"Standard Installation Package","installerDescription":"Use 18-gauge wire on all runs. Check panel capacity before install.","items":[{"id":81376,"parentId":42344,"itemType":"Part","referencedItemId":63140,"createdDate":"2030-08-21T00:22:19Z","lastModifiedDate":"2031-02-06T00:22:19Z","brand":"Sonos","model":"Amp","name":"Installation Labor","shortDescription":"Sonos Amp","clientNote":"Mounted in the rack behind the display.","imageUrl":"https://images.portal.io/catalog/sonos-amp.jpg","msrp":901.23,"sellPrice":583.78,"cost":759.6,"costUpdateDate":"2030-11-10T00:22:19Z","supplier":"Sonos Inc.","quantity":9.6,"total":{"amount":982.49,"currency":{"code":"USD","symbol":"$"},"isCombinedPrice":false},"isTaxExempt":false,"isRecurringService":false,"linkedOrders":[{"orderId":21802,"orderNumber":182,"orderNumberSuffix":"A","supplier":"Sonos Inc.","supplierRef":"SN-10420","orderName":"Living Room Sonos Amp","orderStatus":"Submitted"}]}],"total":796.45,"totalRecurringService":176.35}]}],"financialSummary":{"partsSubtotal":761.41,"partsDiscountType":"Percentage","partsDiscountPercentage":4.17,"partsDiscount":295.66,"partsDiscountTaxable":438.03,"partsDiscountTaxExempt":958.6,"partsTotal":836.45,"laborTotal":178.97,"feeTotal":83.23,"proposalSubtotal":523.07,"salesTax":{"taxStatus":"Ok","total":796.45,"calculation":{"method":"ClientLocation","applyTo":["Parts"],"partsTax":712.26,"partsTaxName":"State Sales Tax","laborTax":452.14,"laborTaxName":"State Labor Tax","hasMultipleTaxSupport":false,"partsTax2":998.32,"partsTax2Name":"County Sales Tax","laborTax2":413.48,"laborTax2Name":"County Labor Tax","feeTax":705.4,"feeTaxName":"State Fee Tax","feeTax2":540.74,"feeTax2Name":"County Fee Tax","taxLocation":{"id":81376,"street":"456 Oak Ave","suite":"Suite 200","city":"Austin","postalCode":"78702","state":"Texas","stateAbbrev":"TX","country":"United States","phone":"555-555-0142"},"isTaxJarAvailable":false,"partsTotalTax":631.22,"laborTotalTax":901.1,"feeTotalTax":324.28}},"proposalTotal":198.47,"currency":{"code":"USD","symbol":"$"}},"profit":{"total":796.45,"percentage":17.45,"partTotal":300.38,"partPercentage":20.26,"laborTotal":178.97,"laborPercentage":4.01,"isProfitIncludeCos":false},"recurringServices":{"items":[{"name":"Monthly Monitoring","sellPrice":583.78,"quantity":9.6,"totalSell":894.05}],"totalRecurringService":176.35},"changeOrders":[{"id":81376,"number":936,"name":"Smith Residence AV - Change Order 1","status":"Draft","total":{"changeOrderTotal":587.75,"currency":{"code":"USD","symbol":"$"}},"customer":{"id":81376,"partyType":"Person","contactType":"Client","firstName":"Jane","lastName":"Smith","companyName":"AV Solutions Inc.","contactEmail":"jane.smith@example.com","contactEmailCC":"billing@example.com","contactPhone":"555-555-0100"},"createdDate":"2030-08-21T00:22:19Z","lastModifiedDate":"2031-02-06T00:22:19Z","lastModifiedByUserDate":"2030-06-26T00:22:19Z"}],"id":81376,"name":"Smith Residence AV"},"examples":{"Example":{"title":"Example","value":{"number":936,"status":"Draft","total":796.45,"customer":{"location":{"id":81376,"street":"456 Oak Ave","suite":"Suite 200","city":"Austin","postalCode":"78702","state":"Texas","stateAbbrev":"TX","country":"United States","phone":"555-555-0142"},"id":81376,"partyType":"Person","contactType":"Client","firstName":"Jane","lastName":"Smith","companyName":"AV Solutions Inc.","contactEmail":"jane.smith@example.com","contactEmailCC":"billing@example.com","contactPhone":"555-555-0100"},"proposalPdf":"https://files.portal.io/proposals/1042.pdf","proposalCsv":"https://files.portal.io/proposals/1042.csv","installerPdf":"https://files.portal.io/proposals/1042-installer.pdf","salesPerson":"Alex Johnson","salesPersonEmail":"alex.johnson@example.com","areas":[{"id":81376,"name":"Living Room","options":[{"id":81376,"status":"Draft","lastModifiedDate":"2031-02-06T00:22:19Z","clientDescription":"Standard Installation Package","installerDescription":"Use 18-gauge wire on all runs. Check panel capacity before install.","items":[{"id":81376,"parentId":42344,"itemType":"Part","referencedItemId":63140,"createdDate":"2030-08-21T00:22:19Z","lastModifiedDate":"2031-02-06T00:22:19Z","brand":"Sonos","model":"Amp","name":"Installation Labor","shortDescription":"Sonos Amp","clientNote":"Mounted in the rack behind the display.","imageUrl":"https://images.portal.io/catalog/sonos-amp.jpg","msrp":901.23,"sellPrice":583.78,"cost":759.6,"costUpdateDate":"2030-11-10T00:22:19Z","supplier":"Sonos Inc.","quantity":9.6,"total":{"amount":982.49,"currency":{"code":"USD","symbol":"$"},"isCombinedPrice":false},"isTaxExempt":false,"isRecurringService":false,"linkedOrders":[{"orderId":21802,"orderNumber":182,"orderNumberSuffix":"A","supplier":"Sonos Inc.","supplierRef":"SN-10420","orderName":"Living Room Sonos Amp","orderStatus":"Submitted"}]}],"total":796.45,"totalRecurringService":176.35}]}],"financialSummary":{"partsSubtotal":761.41,"partsDiscountType":"Percentage","partsDiscountPercentage":4.17,"partsDiscount":295.66,"partsDiscountTaxable":438.03,"partsDiscountTaxExempt":958.6,"partsTotal":836.45,"laborTotal":178.97,"feeTotal":83.23,"proposalSubtotal":523.07,"salesTax":{"taxStatus":"Ok","total":796.45,"calculation":{"method":"ClientLocation","applyTo":["Parts"],"partsTax":712.26,"partsTaxName":"State Sales Tax","laborTax":452.14,"laborTaxName":"State Labor Tax","hasMultipleTaxSupport":false,"partsTax2":998.32,"partsTax2Name":"County Sales Tax","laborTax2":413.48,"laborTax2Name":"County Labor Tax","feeTax":705.4,"feeTaxName":"State Fee Tax","feeTax2":540.74,"feeTax2Name":"County Fee Tax","taxLocation":{"id":81376,"street":"456 Oak Ave","suite":"Suite 200","city":"Austin","postalCode":"78702","state":"Texas","stateAbbrev":"TX","country":"United States","phone":"555-555-0142"},"isTaxJarAvailable":false,"partsTotalTax":631.22,"laborTotalTax":901.1,"feeTotalTax":324.28}},"proposalTotal":198.47,"currency":{"code":"USD","symbol":"$"}},"profit":{"total":796.45,"percentage":17.45,"partTotal":300.38,"partPercentage":20.26,"laborTotal":178.97,"laborPercentage":4.01,"isProfitIncludeCos":false},"recurringServices":{"items":[{"name":"Monthly Monitoring","sellPrice":583.78,"quantity":9.6,"totalSell":894.05}],"totalRecurringService":176.35},"changeOrders":[{"id":81376,"number":936,"name":"Smith Residence AV - Change Order 1","status":"Draft","total":{"changeOrderTotal":587.75,"currency":{"code":"USD","symbol":"$"}},"customer":{"id":81376,"partyType":"Person","contactType":"Client","firstName":"Jane","lastName":"Smith","companyName":"AV Solutions Inc.","contactEmail":"jane.smith@example.com","contactEmailCC":"billing@example.com","contactPhone":"555-555-0100"},"createdDate":"2030-08-21T00:22:19Z","lastModifiedDate":"2031-02-06T00:22:19Z","lastModifiedByUserDate":"2030-06-26T00:22:19Z"}],"id":81376,"name":"Smith Residence AV"}}},"exampleType":"examples"}},"exampleType":"examples"},"e70187c5-8012-49aa-bcd7-c2670c2b5544":{"description":"Authentication failed. Verify the HMAC headers and credentials used for the request.","content":{"application/json":{"schema":{"title":"ErrorResponse","type":"object","properties":{"responseStatus":{"title":"ResponseStatus","type":"object","properties":{"errorCode":{"oneOf":[{"type":"null","uniqueKey":"responseStatus.errorCode.oneOf.0","typeLabel":"null"},{"type":"string","uniqueKey":"responseStatus.errorCode.oneOf.1","typeLabel":"string"}],"uniqueKey":"responseStatus.errorCode","typeLabel":"null | string"},"message":{"oneOf":[{"type":"null","uniqueKey":"responseStatus.message.oneOf.0","typeLabel":"null"},{"type":"string","uniqueKey":"responseStatus.message.oneOf.1","typeLabel":"string"}],"uniqueKey":"responseStatus.message","typeLabel":"null | string"},"stackTrace":{"oneOf":[{"type":"null","uniqueKey":"responseStatus.stackTrace.oneOf.0","typeLabel":"null"},{"type":"string","uniqueKey":"responseStatus.stackTrace.oneOf.1","typeLabel":"string"}],"uniqueKey":"responseStatus.stackTrace","typeLabel":"null | string"},"errors":{"oneOf":[{"type":"null","items":{"title":"ResponseError","type":"object","properties":{"errorCode":{"oneOf":[{"type":"null"},{"type":"string"}]},"fieldName":{"oneOf":[{"type":"null"},{"type":"string"}]},"message":{"oneOf":[{"type":"null"},{"type":"string"}]},"meta":{"oneOf":[{"title":"DictionaryOfStringAndString","type":"null","additionalProperties":{"oneOf":[{"type":"null"},{"type":"string"}]}},{"title":"DictionaryOfStringAndString","type":"object","additionalProperties":{"oneOf":[{"type":"null"},{"type":"string"}]}}]}},"description":"ResponseError"},"uniqueKey":"responseStatus.errors.oneOf.0","typeLabel":"null"},{"type":"array","items":{"title":"ResponseError","type":"object","properties":{"errorCode":{"oneOf":[{"type":"null","uniqueKey":"responseStatus.errors.oneOf.1.items.[INDEX].errorCode.oneOf.0","typeLabel":"null"},{"type":"string","uniqueKey":"responseStatus.errors.oneOf.1.items.[INDEX].errorCode.oneOf.1","typeLabel":"string"}],"uniqueKey":"responseStatus.errors.oneOf.1.items.[INDEX].errorCode","typeLabel":"null | string"},"fieldName":{"oneOf":[{"type":"null","uniqueKey":"responseStatus.errors.oneOf.1.items.[INDEX].fieldName.oneOf.0","typeLabel":"null"},{"type":"string","uniqueKey":"responseStatus.errors.oneOf.1.items.[INDEX].fieldName.oneOf.1","typeLabel":"string"}],"uniqueKey":"responseStatus.errors.oneOf.1.items.[INDEX].fieldName","typeLabel":"null | string"},"message":{"oneOf":[{"type":"null","uniqueKey":"responseStatus.errors.oneOf.1.items.[INDEX].message.oneOf.0","typeLabel":"null"},{"type":"string","uniqueKey":"responseStatus.errors.oneOf.1.items.[INDEX].message.oneOf.1","typeLabel":"string"}],"uniqueKey":"responseStatus.errors.oneOf.1.items.[INDEX].message","typeLabel":"null | string"},"meta":{"oneOf":[{"title":"DictionaryOfStringAndString","type":"null","additionalProperties":{"oneOf":[{"type":"null","uniqueKey":"responseStatus.errors.oneOf.1.items.[INDEX].meta.oneOf.0.additionalProperties.oneOf.0","typeLabel":"null"},{"type":"string","uniqueKey":"responseStatus.errors.oneOf.1.items.[INDEX].meta.oneOf.0.additionalProperties.oneOf.1","typeLabel":"string"}],"uniqueKey":"responseStatus.errors.oneOf.1.items.[INDEX].meta.oneOf.0.additionalProperties","typeLabel":"null | string"},"uniqueKey":"responseStatus.errors.oneOf.1.items.[INDEX].meta.oneOf.0","typeLabel":"null"},{"title":"DictionaryOfStringAndString","type":"object","additionalProperties":{"oneOf":[{"type":"null","uniqueKey":"responseStatus.errors.oneOf.1.items.[INDEX].meta.oneOf.1.additionalProperties.oneOf.0","typeLabel":"null"},{"type":"string","uniqueKey":"responseStatus.errors.oneOf.1.items.[INDEX].meta.oneOf.1.additionalProperties.oneOf.1","typeLabel":"string"}],"uniqueKey":"responseStatus.errors.oneOf.1.items.[INDEX].meta.oneOf.1.additionalProperties","typeLabel":"null | string"},"uniqueKey":"responseStatus.errors.oneOf.1.items.[INDEX].meta.oneOf.1","typeLabel":"DictionaryOfStringAndString · object"}],"uniqueKey":"responseStatus.errors.oneOf.1.items.[INDEX].meta","typeLabel":"null | DictionaryOfStringAndString · object"}},"description":"ResponseError","uniqueKey":"responseStatus.errors.oneOf.1.items.[INDEX]","typeLabel":"ResponseError · object"},"uniqueKey":"responseStatus.errors.oneOf.1","typeLabel":"ResponseError · object[]"}],"uniqueKey":"responseStatus.errors","typeLabel":"null | ResponseError · object[]"},"meta":{"oneOf":[{"title":"DictionaryOfStringAndString","type":"null","additionalProperties":{"oneOf":[{"type":"null","uniqueKey":"responseStatus.meta.oneOf.0.additionalProperties.oneOf.0","typeLabel":"null"},{"type":"string","uniqueKey":"responseStatus.meta.oneOf.0.additionalProperties.oneOf.1","typeLabel":"string"}],"uniqueKey":"responseStatus.meta.oneOf.0.additionalProperties","typeLabel":"null | string"},"uniqueKey":"responseStatus.meta.oneOf.0","typeLabel":"null"},{"title":"DictionaryOfStringAndString","type":"object","additionalProperties":{"oneOf":[{"type":"null","uniqueKey":"responseStatus.meta.oneOf.1.additionalProperties.oneOf.0","typeLabel":"null"},{"type":"string","uniqueKey":"responseStatus.meta.oneOf.1.additionalProperties.oneOf.1","typeLabel":"string"}],"uniqueKey":"responseStatus.meta.oneOf.1.additionalProperties","typeLabel":"null | string"},"uniqueKey":"responseStatus.meta.oneOf.1","typeLabel":"DictionaryOfStringAndString · object"}],"uniqueKey":"responseStatus.meta","typeLabel":"null | DictionaryOfStringAndString · object"}},"description":"ResponseStatus","uniqueKey":"responseStatus","typeLabel":"ResponseStatus · object"}},"description":"ErrorResponse","uniqueKey":"","typeLabel":"ErrorResponse · object"},"example":{"responseStatus":{"errorCode":"Unauthorized","message":"Authentication failed. Verify the HMAC headers and credentials used for the request."}},"examples":{"Example":{"title":"Example","value":{"responseStatus":{"errorCode":"Unauthorized","message":"Authentication failed. Verify the HMAC headers and credentials used for the request."}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"a4e71cdc-024b-4a55-a108-51853ac6eb53":{"mssApiAppId":{"type":"apiKey","description":"Portal application identifier used as part of HMAC-authenticated API requests.","name":"X-MSS-API-APPID","in":"header","scopes":[],"schemeName":"mssApiAppId"},"mssApiUserKey":{"type":"apiKey","description":"Portal user API key used together with the HMAC signature headers.","name":"X-MSS-API-USERKEY","in":"header","scopes":[],"schemeName":"mssApiUserKey"},"mssCustomDate":{"type":"apiKey","description":"Timestamp header included in the signed request to prevent replay attacks.","name":"X-MSS-CUSTOM-DATE","in":"header","scopes":[],"schemeName":"mssCustomDate"},"mssSignature":{"type":"apiKey","description":"HMAC-SHA256 signature for the request, calculated over the canonical string defined in the authentication docs.","name":"X-MSS-SIGNATURE","in":"header","scopes":[],"schemeName":"mssSignature"}}},"servers":{"2356a69a-1607-441f-8551-a7d818f04601":{"url":"https://sandbox.api.portal.io/"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","description":"Portal application identifier used as part of HMAC-authenticated API requests.","name":"X-MSS-API-APPID","in":"header","scopes":[],"schemeName":"mssApiAppId"},"schema":{"title":"X-MSS-API-APPID","type":"string","description":"Portal application identifier used as part of HMAC-authenticated API requests.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"mssApiAppId","name":"X-MSS-API-APPID"},{"scheme":{"type":"apiKey","description":"Portal user API key used together with the HMAC signature headers.","name":"X-MSS-API-USERKEY","in":"header","scopes":[],"schemeName":"mssApiUserKey"},"schema":{"title":"X-MSS-API-USERKEY","type":"string","description":"Portal user API key used together with the HMAC signature headers.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"mssApiUserKey","name":"X-MSS-API-USERKEY"},{"scheme":{"type":"apiKey","description":"Timestamp header included in the signed request to prevent replay attacks.","name":"X-MSS-CUSTOM-DATE","in":"header","scopes":[],"schemeName":"mssCustomDate"},"schema":{"title":"X-MSS-CUSTOM-DATE","type":"string","description":"Timestamp header included in the signed request to prevent replay attacks.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"mssCustomDate","name":"X-MSS-CUSTOM-DATE"},{"scheme":{"type":"apiKey","description":"HMAC-SHA256 signature for the request, calculated over the canonical string defined in the authentication docs.","name":"X-MSS-SIGNATURE","in":"header","scopes":[],"schemeName":"mssSignature"},"schema":{"title":"X-MSS-SIGNATURE","type":"string","description":"HMAC-SHA256 signature for the request, calculated over the canonical string defined in the authentication docs.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"mssSignature","name":"X-MSS-SIGNATURE"}],"title":"mssApiAppId \u0026 mssApiUserKey \u0026 mssCustomDate \u0026 mssSignature"}]},"originalFileLocation":"public.json"},"subdomain":"portalio","siteName":"Portal.io API","title":"Zapier Trigger: Proposal Status Change - Portal.io API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-06T15:29:51.864Z","originalFileLocation":"api-reference/zapier-triggers/proposal-status-change.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Zapier trigger that fires when a proposal\u0026#x27;s status changes in Portal.io.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Portal.io API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/portalio/eSIwBZNUGF9qym-G/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/portalio/eSIwBZNUGF9qym-G/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/portalio/eSIwBZNUGF9qym-G/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/portalio/eSIwBZNUGF9qym-G/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/portalio/eSIwBZNUGF9qym-G/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/portalio/eSIwBZNUGF9qym-G/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/portalio/eSIwBZNUGF9qym-G/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/portalio/eSIwBZNUGF9qym-G/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/portalio/eSIwBZNUGF9qym-G/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Zapier Trigger: Proposal Status Change - Portal.io API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Zapier trigger that fires when a proposal\u0026#x27;s status changes in Portal.io.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Portal.io API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.portal.io/api-reference/zapier-triggers/proposal-status-change\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://portalio.mintlify.app/_mintlify/api/og/v2?division=Zapier+Triggers\u0026amp;title=Zapier+Trigger%3A+Proposal+Status+Change\u0026amp;description=Zapier+trigger+that+fires+when+a+proposal%27s+status+changes+in+Portal.io.\u0026amp;theme=17e1a5d314cfee72ac1850c3\u0026amp;signature=1ed5ba2747246d80043ff9714eb7a757e01ab07c0033360b3c730f9f9631665a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Zapier Trigger: Proposal Status Change - Portal.io API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Zapier trigger that fires when a proposal\u0026#x27;s status changes in Portal.io.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://portalio.mintlify.app/_mintlify/api/og/v2?division=Zapier+Triggers\u0026amp;title=Zapier+Trigger%3A+Proposal+Status+Change\u0026amp;description=Zapier+trigger+that+fires+when+a+proposal%27s+status+changes+in+Portal.io.\u0026amp;theme=17e1a5d314cfee72ac1850c3\u0026amp;signature=1ed5ba2747246d80043ff9714eb7a757e01ab07c0033360b3c730f9f9631665a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/portalio/eSIwBZNUGF9qym-G/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Portal.io API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FF5000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.portal.io/api-reference/zapier-triggers/proposal-status-change\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/zapier-triggers/proposal-status-change.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.portal.io/#organization\",\"name\":\"Portal.io API\",\"url\":\"https://docs.portal.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/portalio/QuSRLNwghuEPmEf4/logo-files/portal-logo-light.svg?fit=max\u0026auto=format\u0026n=QuSRLNwghuEPmEf4\u0026q=85\u0026s=b46857228d074b069b086559f1b032ab\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.portal.io#website\",\"name\":\"Portal.io API\",\"url\":\"https://docs.portal.io\",\"publisher\":{\"@id\":\"https://docs.portal.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.portal.io/api-reference/zapier-triggers/proposal-status-change#webpage\",\"url\":\"https://docs.portal.io/api-reference/zapier-triggers/proposal-status-change\",\"name\":\"Zapier Trigger: Proposal Status Change\",\"description\":\"Zapier trigger that fires when a proposal's status changes in Portal.io.\",\"dateModified\":\"2026-06-06T15:29:51.864Z\",\"isPartOf\":{\"@id\":\"https://docs.portal.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.portal.io/api-reference/zapier-triggers/proposal-status-change#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.portal.io/api-reference/zapier-triggers/proposal-status-change#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Zapier Triggers\",\"item\":\"https://docs.portal.io/api-reference/zapier-triggers/person-modification\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Zapier Trigger: Proposal Status Change\",\"item\":\"https://docs.portal.io/api-reference/zapier-triggers/proposal-status-change\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.portal.io/api-reference/zapier-triggers/proposal-status-change#apireference\",\"headline\":\"Zapier Trigger: Proposal Status Change\",\"name\":\"Zapier Trigger: Proposal Status Change\",\"description\":\"Zapier trigger that fires when a proposal's status changes in Portal.io.\",\"url\":\"https://docs.portal.io/api-reference/zapier-triggers/proposal-status-change\",\"mainEntityOfPage\":{\"@id\":\"https://docs.portal.io/api-reference/zapier-triggers/proposal-status-change#webpage\"},\"dateModified\":\"2026-06-06T15:29:51.864Z\",\"publisher\":{\"@id\":\"https://docs.portal.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.portal.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Portal.io API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Portal.io API","nav":{"global":null,"tabs":[{"tab":"Guide","icon":"book","pages":[{"title":"Guide","href":"/quickstart"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Authentication","pages":[{"title":"Exchange Credentials for a User API Key","sidebarTitle":"Exchange API Key","openapi":"GET /authenticate/apikeyexchange","href":"/api-reference/authentication/exchange-api-key"}]},{"group":"Proposals","pages":[{"title":"List and Search Proposals","sidebarTitle":"List Proposals","openapi":"GET /public/proposals","href":"/api-reference/proposals/list-proposals"},{"title":"Create a New Proposal","sidebarTitle":"Create Proposal","openapi":"POST /public/proposals","href":"/api-reference/proposals/create-proposal"},{"title":"Get Proposal Details","sidebarTitle":"Get Proposal","openapi":"GET /public/proposals/{ProposalId}","href":"/api-reference/proposals/get-proposal"},{"title":"Update a Proposal's Name or Salesperson","sidebarTitle":"Update Proposal","openapi":"POST /public/proposals/{ProposalId}","href":"/api-reference/proposals/update-proposal"},{"title":"Update Proposal Client-Facing Description","sidebarTitle":"Update Description","openapi":"POST /public/proposals/{ProposalId}/description","href":"/api-reference/proposals/update-description"},{"title":"Update Proposal Internal Notes","sidebarTitle":"Internal Notes","openapi":"POST /public/proposals/{ProposalId}/internalnotes","href":"/api-reference/proposals/update-internal-notes"},{"title":"Assign a Contact to a Proposal","sidebarTitle":"Assign Contact","openapi":"POST /public/proposals/{ProposalId}/contact/{ContactId}","href":"/api-reference/proposals/assign-contact"},{"title":"Assign a Location to a Proposal","sidebarTitle":"Assign Location","openapi":"POST /public/proposals/{ProposalId}/location/{LocationId}","href":"/api-reference/proposals/assign-location"},{"title":"Add an Area to a Proposal","sidebarTitle":"Add Area","openapi":"POST /public/proposals/{ProposalId}/area","href":"/api-reference/proposals/add-area"},{"title":"Add an Option to a Proposal Area","sidebarTitle":"Add Area Option","openapi":"POST /public/proposals/{ProposalId}/area/{AreaId}/option","href":"/api-reference/proposals/add-area-option"},{"title":"Update an Area Option's Client Description","sidebarTitle":"Option Client Description","openapi":"POST /public/proposals/{ProposalId}/area-options/{AreaOptionId}/clientdescription","href":"/api-reference/proposals/update-area-client-description"},{"title":"Update an Area Option's Installer Notes","sidebarTitle":"Option Installer Notes","openapi":"POST /public/proposals/{ProposalId}/area-options/{AreaOptionId}/installernotes","href":"/api-reference/proposals/update-area-installer-notes"}]},{"group":"Proposal Items","pages":[{"title":"Proposal Items","sidebarTitle":"Overview","href":"/api-reference/proposals/items/overview"},{"group":"Lifecycle","pages":[{"title":"Add Items to a Proposal","sidebarTitle":"Add Items","openapi":"POST /public/proposals/{ProposalId}/items","href":"/api-reference/proposals/items/add-items"},{"title":"Delete Items from a Proposal","sidebarTitle":"Delete Items","openapi":"DELETE /public/proposals/{ProposalId}/items","href":"/api-reference/proposals/items/delete-items"},{"title":"Replace a Proposal Item","sidebarTitle":"Replace Item","openapi":"POST /public/proposals/{ProposalId}/items/{ProposalItemId}/replace","href":"/api-reference/proposals/items/replace-item"}]},{"group":"Pricing","pages":[{"title":"Update Proposal Item Quantity","sidebarTitle":"Update Quantity","openapi":"POST /public/proposals/{ProposalId}/items/{ProposalItemId}/qty","href":"/api-reference/proposals/items/update-item-quantity"},{"title":"Update Proposal Item Sell Price","sidebarTitle":"Update Sell Price","openapi":"POST /public/proposals/{ProposalId}/items/{ProposalItemId}/sellprice","href":"/api-reference/proposals/items/update-item-sell-price"},{"title":"Update Proposal Item Supplier Cost","sidebarTitle":"Update Cost","openapi":"POST /public/proposals/{ProposalId}/items/{ProposalItemId}/cost","href":"/api-reference/proposals/items/update-item-cost"},{"title":"Update Proposal Item MSRP","sidebarTitle":"Update MSRP","openapi":"POST /public/proposals/{ProposalId}/items/{ProposalItemId}/msrp","href":"/api-reference/proposals/items/update-item-msrp"},{"title":"Set Proposal Item Combined Pricing","sidebarTitle":"Combined Pricing","openapi":"POST /public/proposals/{ProposalId}/items/{ProposalItemId}/combineprice","href":"/api-reference/proposals/items/set-item-combined-pricing"},{"title":"Refresh Proposal Item Costs","sidebarTitle":"Refresh Costs","openapi":"POST /public/proposals/{ProposalId}/items/costupdate","href":"/api-reference/proposals/items/refresh-item-costs"}]},{"group":"Content","pages":[{"title":"Update Proposal Item Short Description","sidebarTitle":"Update Description","openapi":"POST /public/proposals/{ProposalId}/items/{ProposalItemId}/shortdescription","href":"/api-reference/proposals/items/update-item-short-description"},{"title":"Update Proposal Item Client Note","sidebarTitle":"Update Note","openapi":"POST /public/proposals/{ProposalId}/items/{ProposalItemId}/note","href":"/api-reference/proposals/items/update-item-note"},{"title":"Update Proposal Item Image","sidebarTitle":"Update Image","openapi":"POST /public/proposals/{ProposalId}/items/{ProposalItemId}/image","href":"/api-reference/proposals/items/update-item-image"}]},{"group":"Flags","pages":[{"title":"Update Proposal Item Tax-Exempt Flag","sidebarTitle":"Tax-Exempt Flag","openapi":"POST /public/proposals/{ProposalId}/items/{ProposalItemId}/taxexempt","href":"/api-reference/proposals/items/update-item-tax-exempt"},{"title":"Update Proposal Item Recurring-Service Flag","sidebarTitle":"Recurring-Service Flag","openapi":"POST /public/proposals/{ProposalId}/items/{ProposalItemId}/recurringservice","href":"/api-reference/proposals/items/update-item-recurring-service"}]},{"group":"Organization","pages":[{"title":"Move Proposal Items","sidebarTitle":"Move Items","openapi":"POST /public/proposals/{ProposalId}/items/move","href":"/api-reference/proposals/items/move-items"},{"title":"Copy Proposal Items","sidebarTitle":"Copy Items","openapi":"POST /public/proposals/{ProposalId}/items/copy","href":"/api-reference/proposals/items/copy-items"}]},{"group":"Suppliers","pages":[{"title":"List Proposal Item Suppliers","sidebarTitle":"List Suppliers","openapi":"GET /public/proposals/{ProposalId}/items/{ProposalItemId}/suppliers","href":"/api-reference/proposals/items/list-item-suppliers"},{"title":"Set Proposal Item Supplier","sidebarTitle":"Set Supplier","openapi":"POST /public/proposals/{ProposalId}/items/{ProposalItemId}/supplier/{SupplierId}","href":"/api-reference/proposals/items/set-item-supplier"}]}]},{"group":"Change Orders","pages":[{"title":"List Change Orders for a Proposal","sidebarTitle":"List Change Orders","openapi":"GET /public/proposals/{ProposalId}/changeorders","href":"/api-reference/change-orders/list-change-orders"},{"title":"Get Change Order Details","sidebarTitle":"Get Change Order","openapi":"GET /public/proposals/{ProposalId}/changeorders/{ChangeOrderId}","href":"/api-reference/change-orders/get-change-order"}]},{"group":"AI Builder","pages":[{"title":"List AI Builder Content for a Proposal","sidebarTitle":"List Content","openapi":"GET /public/proposals/{ProposalId}/ai/content","href":"/api-reference/ai-builder/list-content"},{"title":"Upload AI Builder Content to a Proposal","sidebarTitle":"Upload Content","openapi":"POST /public/proposals/{ProposalId}/ai/content","playground":"none","href":"/api-reference/ai-builder/upload-content"},{"title":"Delete AI Builder Content from a Proposal","sidebarTitle":"Delete Content","openapi":"DELETE /public/proposals/{ProposalId}/ai/content/{ContentId}","href":"/api-reference/ai-builder/delete-content"},{"title":"Get the AI-Generated Outline for a Proposal","sidebarTitle":"Get Outline","openapi":"GET /public/proposals/{ProposalId}/ai/outline","href":"/api-reference/ai-builder/get-outline"},{"title":"Build a Proposal from an AI-Generated Outline","sidebarTitle":"Build Proposal","openapi":"POST /public/proposals/{ProposalId}/ai/build","href":"/api-reference/ai-builder/build-proposal"},{"title":"Generate an AI Outline for a Proposal","sidebarTitle":"Generate Outline","openapi":"POST /public/proposals/{ProposalId}/ai/outline","href":"/api-reference/ai-builder/generate-outline"}]},{"group":"People","pages":[{"title":"Search and List Contacts in Your Account","sidebarTitle":"List Contacts","openapi":"GET /public/people","href":"/api-reference/people/list-contacts"},{"title":"Create a New Contact in Your Account","sidebarTitle":"Create Contact","openapi":"POST /public/people","href":"/api-reference/people/create-contact"},{"title":"Get Contact Details by ID","sidebarTitle":"Get Contact","openapi":"GET /public/people/{PersonId}","href":"/api-reference/people/get-contact"},{"title":"List Locations for a Contact","sidebarTitle":"List Locations","openapi":"GET /public/people/{ContactId}/location","href":"/api-reference/people/list-locations"},{"title":"Add a Location to a Contact","sidebarTitle":"Create Location","openapi":"POST /public/people/{ContactId}/location","href":"/api-reference/people/create-location"}]},{"group":"Catalog","pages":[{"title":"Search Catalog Items in Your Account","sidebarTitle":"Search Items","openapi":"GET /public/catalog","href":"/api-reference/catalog/search-items"},{"title":"List Catalog Categories","sidebarTitle":"List Categories","openapi":"GET /public/catalog/categories","href":"/api-reference/catalog/list-categories"},{"title":"Get Catalog Item Details","sidebarTitle":"Get Item","openapi":"GET /public/catalog/{ItemId}","href":"/api-reference/catalog/get-item"}]},{"group":"Users","pages":[{"title":"List Users in Your Account","sidebarTitle":"List Users","openapi":"GET /public/users","href":"/api-reference/users/list-users"}]},{"group":"Webhooks","pages":[{"title":"Create a Webhook Subscription","sidebarTitle":"Create Subscription","openapi":"POST /public/webhook/subscribe","href":"/api-reference/webhooks/create-subscription"},{"title":"List Your Webhook Subscriptions","sidebarTitle":"List Subscriptions","openapi":"GET /public/webhook/subscriptions","href":"/api-reference/webhooks/list-subscriptions"},{"title":"Update a Webhook Subscription","sidebarTitle":"Update Subscription","openapi":"POST /public/webhook/subscription/{SubscriptionId}","href":"/api-reference/webhooks/update-subscription"},{"title":"Delete a Webhook Subscription","sidebarTitle":"Delete Subscription","openapi":"DELETE /public/webhook/unsubscribe/{SubscriptionId}","href":"/api-reference/webhooks/delete-subscription"},{"title":"Portal.io API Webhook Event Reference","sidebarTitle":"Event Types","href":"/api-reference/webhooks/events"}]},{"group":"Zapier Triggers","pages":[{"title":"Zapier Trigger: Person Modification","openapi":"GET /zapier/trigger/person","href":"/api-reference/zapier-triggers/person-modification"},{"title":"Zapier Trigger: Payment Status Change","description":"Zapier trigger that fires when a payment's status changes in Portal.io.","openapi":"GET /zapier/trigger/payment","href":"/api-reference/zapier-triggers/payment-status-change"},{"title":"Zapier Trigger: Proposal Status Change","openapi":"GET /zapier/trigger/proposal","href":"/api-reference/zapier-triggers/proposal-status-change"},{"title":"Zapier Trigger: Order Status Change","description":"Zapier trigger that fires when an order's status changes in Portal.io.","openapi":"GET /zapier/trigger/order","href":"/api-reference/zapier-triggers/order-status-change"},{"title":"Zapier Trigger: Change Order Status Change","href":"/api-reference/zapier-triggers/change-order-status-change"}]}]},{"tab":"Updates","icon":"bolt","pages":[{"title":"Updates","href":"/changelog"}]}]},"title":"Zapier Trigger: Proposal Status Change - Portal.io API","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}