Create a deal from a qualified opportunity and associate the two. Use **Associate an Opportunity with a Deal** instead when the deal already exists, or **Create a Deal** for a deal without an opportunity.
The deal copies the opportunity's contact, site and line items, and starts at the given `stage`. Its name is "<contact name or email> Deal" unless you send `name`. An archived opportunity is unarchived. `deal.created` and `opportunity.associated` webhooks fire, and an assignee is notified by email. Send an `Idempotency-Key` header so a retry doesn't create a second deal.
See [Capture and qualify leads](https://docs.stora.co/2025-09/guides/opportunities-and-deals).
Required authorization scopes: `public.opportunity:write`, `public.deal:write`
A unique key, such as a UUID, that makes it safe to retry this request. The first successful (2xx) response for a key is stored for 24 hours and returned unchanged, including its request_id, for later requests with the same key, without running the request again. Keys are unique per operator, case-insensitive and trimmed of surrounding whitespace. Failed requests are not stored, so they can be retried with the same key. While a request with the same key is still in progress, another one returns 409 Conflict with code idempotency_conflict. The request body and path are not compared, so use a new key for each request. For more, see the documentation page.
Path Parameters
opportunity_id
string
required
The ID of the opportunity
Pattern: ^opp_
Query Parameters
expand
string[]
This endpoint supports expandable responses. For more, see the documentation page.
fields
string[]
Returns only the listed fields, such as id,status,site.name. Identifiers and constant fields such as object are always returned. A field inside an expandable association also needs it in expand, unless the collapsed association returns it, such as site.id. For more, see the documentation page.
Body
application/json
Create Deal from Opportunity Request
stage
object
required
Pipeline stage the new deal starts in.
Show child attributes
name
string
The name of the deal. Defaults to the contact's name, or email if the contact has no name, followed by "Deal".
assignee
object | null
Staff member responsible for the new deal.
Show child attributes
note
string | null
Free-text note for the deal. Displayed under 'Deal value estimate' in Backoffice.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Stora","colors":{"primary":"#05195A","light":"#F54309","dark":"#13183E"},"logo":{"light":"https://mintcdn.com/stora-f4154d0c/OkDRMCLydnzT1IFG/logo/stora-logo.svg?fit=max\u0026auto=format\u0026n=OkDRMCLydnzT1IFG\u0026q=85\u0026s=208e8987df1797b88ccc8c1c418f8126","dark":"https://mintcdn.com/stora-f4154d0c/dmKerB3EhgN2KR1E/logo/stora-logo-white.svg?fit=max\u0026auto=format\u0026n=dmKerB3EhgN2KR1E\u0026q=85\u0026s=952b96d5123da5b794de397c9d2edacb"},"favicon":"https://mintcdn.com/stora-f4154d0c/OkDRMCLydnzT1IFG/favicon.svg?fit=max\u0026auto=format\u0026n=OkDRMCLydnzT1IFG\u0026q=85\u0026s=03693c34ec06252c51107f6d1057a0ac","appearance":{"default":"system"},"navbar":{"links":[{"href":"https://stora.co/contact","label":"Contact"}],"primary":{"type":"button","label":"Book a demo","href":"https://stora.co/get-started"}},"integrations":{"intercom":{"appId":"qaw9usmk"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"stora-f4154d0c","hasAudioNarration":false,"actualSubdomain":"stora-f4154d0c","customDomains":["docs.stora.co"],"gitSource":{"type":"github","owner":"stora-co","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b0059debaa97067db112ec3","clientVersion":"0.0.4248","searchFilterCounts":[{"language":"default","tag":"API reference","count":187},{"language":"default","tag":"Webhooks","count":73},{"language":"default","tag":"Guides","count":31},{"language":"default","tag":"Opportunities","count":10},{"language":"default","tag":"Building integrations","count":8},{"language":"default","tag":"Deals","count":8},{"language":"default","tag":"Orders","count":8},{"language":"default","tag":"Working with the API","count":7},{"language":"default","tag":"Tasks","count":7},{"language":"default","tag":"Units","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"api@stora.co","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","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":"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":"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":"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":"site-roles","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":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"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":"workos-sso-scim","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},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"img.nav-logo{height:21px}.mermaid .node rect{rx:0.375rem;ry:0.375rem}.mermaid .edgeLabel,.mermaid .edgeLabel .labelBkg{border-radius:4px!important}[data-component-part=\"update-tag\"]{padding:0.0625rem 0.375rem;background-color:#f4f4f5;border:1px solid #e4e4e7;font-size:0.75rem}.dark [data-component-part=\"update-tag\"]{background-color:#27272a;border-color:#3f3f46}.mermaid .edgeLabel p{color:#ffffff!important;font-size:0.625rem!important;font-weight:700!important;text-transform:uppercase!important;letter-spacing:0.05em!important}.dark .mermaid .messageText,.dark .mermaid .labelText,.dark .mermaid .labelText>tspan,.dark .mermaid .loopText,.dark .mermaid .loopText>tspan{fill:#f4f4f5!important;stroke:none!important}.dark .mermaid .messageLine0,.dark .mermaid .messageLine1{stroke:#ff7237!important}.dark .mermaid marker[id$=\"-arrowhead\"] path,.dark .mermaid marker[id$=\"-filled-head\"] path{fill:#ff7237!important;stroke:#ff7237!important}.dark .mermaid marker[id$=\"-crosshead\"] path{stroke:#ff7237!important}[data-nav-tag=\"Beta\"],[data-nav-tag=\"Beta\"] *{background-color:#f87171;color:white!important}[data-nav-tag=\"Changing\"],[data-nav-tag=\"Changing\"] *{background-color:#f59e0b;color:white!important}"}]}
{"page":{"pagePath":"2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity","slug":"/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity","pageMetadata":{"title":"Create a Deal from an Opportunity","description":"Create a deal from a qualified opportunity and associate the two. Use **Associate an Opportunity with a Deal** instead when the deal already exists, or **Create a Deal** for a deal without an opportunity.\n\nThe deal copies the opportunity's contact, site and line items, and starts at the given `stage`. Its name is \"\u003ccontact name or email> Deal\" unless you send `name`. An archived opportunity is unarchived. `deal.created` and `opportunity.associated` webhooks fire, and an assignee is notified by email. Send an `Idempotency-Key` header so a retry doesn't create a second deal.\n\nSee [Capture and qualify leads](https://docs.stora.co/2025-09/guides/opportunities-and-deals).\n\nRequired authorization scopes: `public.opportunity:write`, `public.deal:write`\n","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json post /2025-09/opportunities/{opportunity_id}/deal","href":"/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity","autogeneratedByOpenApi":true},"description":"Create a deal from a qualified opportunity and associate the two. Use **Associate an Opportunity with a Deal** instead when the deal already exists, or **Create a Deal** for a deal without an opportunity.\n\nThe deal copies the opportunity's contact, site and line items, and starts at the given `stage`. Its name is \"\u003ccontact name or email> Deal\" unless you send `name`. An archived opportunity is unarchived. `deal.created` and `opportunity.associated` webhooks fire, and an assignee is notified by email. Send an `Idempotency-Key` header so a retry doesn't create a second deal.\n\nSee [Capture and qualify leads](https://docs.stora.co/2025-09/guides/opportunities-and-deals).\n\nRequired authorization scopes: `public.opportunity:write`, `public.deal:write`\n","pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}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":"Create a Deal from an Opportunity","description":"Create a deal from a qualified opportunity and associate the two. Use **Associate an Opportunity with a Deal** instead when the deal already exists, or **Create a Deal** for a deal without an opportunity.\n\nThe deal copies the opportunity's contact, site and line items, and starts at the given `stage`. Its name is \"\u003ccontact name or email> Deal\" unless you send `name`. An archived opportunity is unarchived. `deal.created` and `opportunity.associated` webhooks fire, and an assignee is notified by email. Send an `Idempotency-Key` header so a retry doesn't create a second deal.\n\nSee [Capture and qualify leads](https://docs.stora.co/2025-09/guides/opportunities-and-deals).\n\nRequired authorization scopes: `public.opportunity:write`, `public.deal:write`\n","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json post /2025-09/opportunities/{opportunity_id}/deal","href":"/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create a Deal from an Opportunity","tags":["Opportunities"],"operationId":"opportunity_deal_create","description":"Create a deal from a qualified opportunity and associate the two. Use **Associate an Opportunity with a Deal** instead when the deal already exists, or **Create a Deal** for a deal without an opportunity.\n\nThe deal copies the opportunity's contact, site and line items, and starts at the given `stage`. Its name is \"\u003ccontact name or email> Deal\" unless you send `name`. An archived opportunity is unarchived. `deal.created` and `opportunity.associated` webhooks fire, and an assignee is notified by email. Send an `Idempotency-Key` header so a retry doesn't create a second deal.\n\nSee [Capture and qualify leads](https://docs.stora.co/2025-09/guides/opportunities-and-deals).\n\nRequired authorization scopes: `public.opportunity:write`, `public.deal:write`\n","security":["fc31f212-a0f8-485d-bda0-93ba35865f8d","bfac8194-5b72-4ced-b509-abf3e291166d"],"parameters":["ed70fd8f-69e1-42ff-8c44-9bf6e8cdcda8","f870e235-32f2-4b6b-be37-18cc28e83211","63d38b78-ede8-4858-9160-a3ff4c037f3f"],"x-mint":{"metadata":{"tag":"Beta"}},"responses":{"201":"70be3edd-84a9-4e6a-b440-4be3f7bcc142","404":"c015b632-a19a-4ab5-9aea-c7ff14d986e8","409":"cd070215-2e00-4194-a38c-47de8f4ae068","422":"c022b146-d354-412d-9165-0f89b921983d"},"requestBody":"3a77a4e1-982e-47d2-b4d0-c4f904051fa6","method":"post","type":"path","servers":["c00b03b8-e30a-4d5a-a9cb-b56d21be1633"],"path":"/2025-09/opportunities/{opportunity_id}/deal","baseUrlOptions":["https://public-api.stora.co"],"title":"Create a Deal from an Opportunity","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"ed70fd8f-69e1-42ff-8c44-9bf6e8cdcda8":{"name":"expand","in":"query","required":false,"description":"This endpoint supports expandable responses. For more, see the [documentation page](https://docs.stora.co/2025-09/guides/responses#expanding-responses).","style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"isRequired":false,"description":"This endpoint supports expandable responses. For more, see the [documentation page](https://docs.stora.co/2025-09/guides/responses#expanding-responses).","uniqueKey":"","typeLabel":"string[]"}},"f870e235-32f2-4b6b-be37-18cc28e83211":{"name":"Idempotency-Key","in":"header","required":false,"description":"A unique key, such as a UUID, that makes it safe to retry this request. The first successful (2xx) response for a key is stored for 24 hours and returned unchanged, including its `request_id`, for later requests with the same key, without running the request again. Keys are unique per operator, case-insensitive and trimmed of surrounding whitespace. Failed requests are not stored, so they can be retried with the same key. While a request with the same key is still in progress, another one returns `409 Conflict` with code `idempotency_conflict`. The request body and path are not compared, so use a new key for each request. For more, see the [documentation page](https://docs.stora.co/2025-09/guides/requests#idempotent-requests).","schema":{"type":"string","isRequired":false,"description":"A unique key, such as a UUID, that makes it safe to retry this request. The first successful (2xx) response for a key is stored for 24 hours and returned unchanged, including its `request_id`, for later requests with the same key, without running the request again. Keys are unique per operator, case-insensitive and trimmed of surrounding whitespace. Failed requests are not stored, so they can be retried with the same key. While a request with the same key is still in progress, another one returns `409 Conflict` with code `idempotency_conflict`. The request body and path are not compared, so use a new key for each request. For more, see the [documentation page](https://docs.stora.co/2025-09/guides/requests#idempotent-requests).","uniqueKey":"","typeLabel":"string"},"example":"8e03978e-40d5-43e8-bc93-6894a57f9324"},"63d38b78-ede8-4858-9160-a3ff4c037f3f":{"name":"fields","in":"query","required":false,"description":"Returns only the listed fields, such as `id,status,site.name`. Identifiers and constant fields such as `object` are always returned. A field inside an expandable association also needs it in `expand`, unless the collapsed association returns it, such as `site.id`. For more, see the [documentation page](https://docs.stora.co/2025-09/guides/responses#selecting-fields).","style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"isRequired":false,"description":"Returns only the listed fields, such as `id,status,site.name`. Identifiers and constant fields such as `object` are always returned. A field inside an expandable association also needs it in `expand`, unless the collapsed association returns it, such as `site.id`. For more, see the [documentation page](https://docs.stora.co/2025-09/guides/responses#selecting-fields).","uniqueKey":"","typeLabel":"string[]"}},"8b795cad-138c-45aa-89db-6def221da3f3":{"name":"opportunity_id","in":"path","required":true,"description":"The ID of the opportunity","schema":{"type":"string","pattern":"^opp_","isRequired":true,"description":"The ID of the opportunity","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["stage"],"properties":{"stage":{"type":"object","required":["id"],"properties":{"id":{"type":"string","pattern":"^dstg_","description":"ID of the deal stage (`dstg_…`).","isRequired":true,"uniqueKey":"stage.id","typeLabel":"string"}},"additionalProperties":false,"description":"Pipeline stage the new deal starts in.","isRequired":true,"uniqueKey":"stage","typeLabel":"object"},"name":{"type":"string","description":"The name of the deal. Defaults to the contact's name, or email if the contact has no name, followed by \"Deal\".","uniqueKey":"name","typeLabel":"string"},"assignee":{"oneOf":[{"type":"object","required":["id"],"properties":{"id":{"oneOf":[{"type":"string","pattern":"^staff_","description":"ID of the staff member (`staff_…`).","isRequired":true,"uniqueKey":"assignee.oneOf.0.id.oneOf.0","typeLabel":"string"},{"type":"null","pattern":"^staff_","description":"ID of the staff member (`staff_…`).","isRequired":true,"uniqueKey":"assignee.oneOf.0.id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"assignee.oneOf.0.id","typeLabel":"string | null"}},"additionalProperties":false,"description":"Staff member responsible for the new deal.","uniqueKey":"assignee.oneOf.0","typeLabel":"object"},{"type":"null","required":["id"],"properties":{"id":{"oneOf":[{"type":"string","pattern":"^staff_","description":"ID of the staff member (`staff_…`)."},{"type":"null","pattern":"^staff_","description":"ID of the staff member (`staff_…`)."}]}},"additionalProperties":false,"description":"Staff member responsible for the new deal.","uniqueKey":"assignee.oneOf.1","typeLabel":"null"}],"uniqueKey":"assignee","typeLabel":"object | null"},"note":{"oneOf":[{"type":"string","description":"Free-text note for the deal. Displayed under 'Deal value estimate' in Backoffice.","uniqueKey":"note.oneOf.0","typeLabel":"string"},{"type":"null","description":"Free-text note for the deal. Displayed under 'Deal value estimate' in Backoffice.","uniqueKey":"note.oneOf.1","typeLabel":"null"}],"uniqueKey":"note","typeLabel":"string | null"},"metadata":{"oneOf":[{"type":"object","additionalProperties":{"type":"string","uniqueKey":"metadata.oneOf.0.additionalProperties","typeLabel":"string"},"maxProperties":20,"description":"Set of key-value pairs for storing additional information on the deal. [Learn more about metadata.](https://docs.stora.co/2025-09/guides/metadata)","uniqueKey":"metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"string","uniqueKey":"metadata.oneOf.1.additionalProperties","typeLabel":"string"},"maxProperties":20,"description":"Set of key-value pairs for storing additional information on the deal. [Learn more about metadata.](https://docs.stora.co/2025-09/guides/metadata)","uniqueKey":"metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"metadata","typeLabel":"object | null"}},"additionalProperties":false,"description":"Create Deal from Opportunity Request","uniqueKey":"","typeLabel":"object"},"examples":{"deal_created_from_the_opportunity":{"title":"deal_created_from_the_opportunity","summary":"deal created from the opportunity","value":{"stage":{"id":"dstg_127b3057d5df338e"},"name":"Jane Doe Storage","assignee":{"id":"staff_947b3057d5df338e"},"note":"Around 100 a month","metadata":{"source":"zapier"}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"70be3edd-84a9-4e6a-b440-4be3f7bcc142":{"description":"deal created from the opportunity","content":{"application/json":{"examples":{"default":{"title":"default","summary":"deal created from the opportunity","value":{"deal":{"id":"deal_d1ce34c57bfefff7","assignee":{"id":"staff_947b3057d5df338e"},"contact":{"id":"con_1234567890abcdef"},"created_at":"2025-02-22T14:41:00Z","creator":{"id":"app_99b90b9d208a137b"},"line_items":[{"item":{"id":"plvl_e8f3ad0a07e47566"},"quantity":1,"type":"protection"},{"item":{"id":"utype_f18fc91387cdf710"},"quantity":1,"type":"unit_type"}],"lost_reason":null,"metadata":{"source":"zapier"},"name":"Jane Doe Storage","note":"Around 100 a month","site":{"id":"site_14b419f1096013f1"},"stage":{"id":"dstg_127b3057d5df338e"},"starts_at":null,"status":"open","updated_at":"2025-02-22T14:41:00Z","value_estimate":"Around 100 a month"},"meta":{"request_id":"01563646-58c1-4607-8fe0-cae3e92c4477","curies":[{"name":"bo","href":"https://app.stora.test{rel}","templated":true,"title":"Backoffice"},{"name":"sf","href":"https://acme.stora.test{rel}","templated":true,"title":"Storefront"}]}}}},"schema":{"type":"object","required":["deal","meta"],"properties":{"deal":{"type":"object","description":"Deal","required":["id","assignee","contact","created_at","creator","line_items","lost_reason","metadata","name","note","site","stage","starts_at","status","updated_at","value_estimate"],"properties":{"id":{"type":"string","pattern":"^deal_","description":"Unique identifier for the deal (`deal_…`).","isRequired":true,"uniqueKey":"deal.id","typeLabel":"string"},"assignee":{"oneOf":[{"type":"object","description":"Staff member assigned to the deal. **Expandable** (shows only ID when not expanded).","required":["id","created_at","email","name","updated_at"],"properties":{"id":{"type":"string","pattern":"^staff_","description":"Unique identifier for the staff member (`staff_…`).","isRequired":true,"uniqueKey":"deal.assignee.oneOf.0.id","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","description":"Creation date and time of the staff.","isRequired":true,"uniqueKey":"deal.assignee.oneOf.0.created_at","typeLabel":"string\u003cdate-time>"},"email":{"type":"string","format":"email","description":"Email address of the staff member.","isRequired":true,"uniqueKey":"deal.assignee.oneOf.0.email","typeLabel":"string\u003cemail>"},"name":{"type":"string","description":"Full name of the staff member.","isRequired":true,"uniqueKey":"deal.assignee.oneOf.0.name","typeLabel":"string"},"updated_at":{"type":"string","format":"date-time","description":"Last update date and time of the staff.","isRequired":true,"uniqueKey":"deal.assignee.oneOf.0.updated_at","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.assignee.oneOf.0","typeLabel":"object"},{"type":"object","description":"Staff member assigned to the deal. **Expandable** (shows only ID when not expanded).","required":["id"],"properties":{"id":{"type":"string","pattern":"^staff_","description":"Unique identifier for the staff member (`staff_…`).","isRequired":true,"uniqueKey":"deal.assignee.oneOf.1.id","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.assignee.oneOf.1","typeLabel":"object"},{"type":"null","description":"Staff member assigned to the deal. **Expandable** (shows only ID when not expanded).","isRequired":true,"uniqueKey":"deal.assignee.oneOf.2","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.assignee","typeLabel":"object · object · null"},"contact":{"oneOf":[{"type":"object","description":"Contact associated with the deal. **Expandable** (shows only ID when not expanded).","required":["id","accounting_code","address","company_registration_number","created_at","email","full_name","identity_check","marketing_source","metadata","phone_number","source","status","stripe_customer_id","tax_id","tenancies_count","type","updated_at","use_case"],"properties":{"id":{"type":"string","pattern":"^con_","description":"Unique identifier for the contact (`con_…`).","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.id","typeLabel":"string"},"accounting_code":{"oneOf":[{"type":"string","description":"The contact's account reference in your accounting software, included in invoice exports.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.accounting_code.oneOf.0","typeLabel":"string"},{"type":"null","description":"The contact's account reference in your accounting software, included in invoice exports.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.accounting_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.contact.oneOf.0.accounting_code","typeLabel":"string | null"},"address":{"oneOf":[{"type":"object","description":"Address of the contact, `null` when no address is set.","required":["city","country_alpha2","line_1","line_2","postal_code","state"],"properties":{"city":{"oneOf":[{"type":"string","description":"City","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.address.oneOf.0.city.oneOf.0","typeLabel":"string"},{"type":"null","description":"City","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.address.oneOf.0.city.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.contact.oneOf.0.address.oneOf.0.city","typeLabel":"string | null"},"country_alpha2":{"oneOf":[{"type":"string","enum":["AD","AE","AF","AG","AI","AL","AM","AO","AQ","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BV","BW","BY","BZ","CA","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CW","CX","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR","HT","HU","ID","IE","IL","IM","IN","IO","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NF","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","UM","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","YE","YT","ZA","ZM","ZW",null],"description":"Country Alpha 2","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.address.oneOf.0.country_alpha2.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["AD","AE","AF","AG","AI","AL","AM","AO","AQ","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BV","BW","BY","BZ","CA","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CW","CX","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR","HT","HU","ID","IE","IL","IM","IN","IO","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NF","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","UM","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","YE","YT","ZA","ZM","ZW",null],"description":"Country Alpha 2","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.address.oneOf.0.country_alpha2.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.contact.oneOf.0.address.oneOf.0.country_alpha2","typeLabel":"enum\u003cstring> | null"},"line_1":{"oneOf":[{"type":"string","description":"Line 1","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.address.oneOf.0.line_1.oneOf.0","typeLabel":"string"},{"type":"null","description":"Line 1","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.address.oneOf.0.line_1.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.contact.oneOf.0.address.oneOf.0.line_1","typeLabel":"string | null"},"line_2":{"oneOf":[{"type":"string","description":"Line 2","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.address.oneOf.0.line_2.oneOf.0","typeLabel":"string"},{"type":"null","description":"Line 2","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.address.oneOf.0.line_2.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.contact.oneOf.0.address.oneOf.0.line_2","typeLabel":"string | null"},"postal_code":{"oneOf":[{"type":"string","description":"Postal code","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.address.oneOf.0.postal_code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Postal code","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.address.oneOf.0.postal_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.contact.oneOf.0.address.oneOf.0.postal_code","typeLabel":"string | null"},"state":{"oneOf":[{"type":"string","description":"State or province, ISO 3166-2 only","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.address.oneOf.0.state.oneOf.0","typeLabel":"string"},{"type":"null","description":"State or province, ISO 3166-2 only","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.address.oneOf.0.state.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.contact.oneOf.0.address.oneOf.0.state","typeLabel":"string | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.contact.oneOf.0.address.oneOf.0","typeLabel":"object"},{"type":"null","description":"Address of the contact, `null` when no address is set.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.address.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.contact.oneOf.0.address","typeLabel":"object | null"},"company_registration_number":{"oneOf":[{"type":"string","description":"Company registration number of the contact.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.company_registration_number.oneOf.0","typeLabel":"string"},{"type":"null","description":"Company registration number of the contact.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.company_registration_number.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.contact.oneOf.0.company_registration_number","typeLabel":"string | null"},"created_at":{"type":"string","format":"date-time","description":"Creation date and time of the contact.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.created_at","typeLabel":"string\u003cdate-time>"},"email":{"type":"string","format":"email","description":"Email address of the contact.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.email","typeLabel":"string\u003cemail>"},"full_name":{"type":"string","description":"Full name of the contact.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.full_name","typeLabel":"string"},"identity_check":{"type":"object","description":"Identity check requirement and status of the contact.","required":["required","status"],"properties":{"required":{"type":"boolean","description":"Whether the contact is required to complete identity verification based on the operator's checkin settings.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.identity_check.required","typeLabel":"boolean"},"status":{"type":"string","enum":["failed","processing","succeeded","cancelled","not_attempted"],"description":"Status of the contact's latest identity verification. `not_attempted` is unique to this field (infers no identity verification resource yet exists for this contact).","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.identity_check.status","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.contact.oneOf.0.identity_check","typeLabel":"object"},"marketing_source":{"oneOf":[{"type":"string","enum":["used_before","recommendation","received_leaflet","seen_building_signs","seen_advert","facebook_marketplace","google_search","other_online_search","social_media","email","radio","other",null],"description":"Source of marketing for the contact.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.marketing_source.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["used_before","recommendation","received_leaflet","seen_building_signs","seen_advert","facebook_marketplace","google_search","other_online_search","social_media","email","radio","other",null],"description":"Source of marketing for the contact.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.marketing_source.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.contact.oneOf.0.marketing_source","typeLabel":"enum\u003cstring> | null"},"metadata":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"deal.contact.oneOf.0.metadata.additionalProperties","typeLabel":"string"},"maxProperties":20,"description":"Set of key-value pairs for storing additional information. [Learn more about metadata.](https://docs.stora.co/2025-09/guides/metadata)","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.metadata","typeLabel":"object"},"phone_number":{"oneOf":[{"type":"string","description":"Phone number of the contact.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.phone_number.oneOf.0","typeLabel":"string"},{"type":"null","description":"Phone number of the contact.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.phone_number.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.contact.oneOf.0.phone_number","typeLabel":"string | null"},"source":{"oneOf":[{"type":"string","enum":["pre_open","incomplete_booking","registered_interest","price_interest","quotation_request","booking","popup","external_enquiry","phone","walkin","import","other",null],"description":"Source of the contact information.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.source.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["pre_open","incomplete_booking","registered_interest","price_interest","quotation_request","booking","popup","external_enquiry","phone","walkin","import","other",null],"description":"Source of the contact information.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.source.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.contact.oneOf.0.source","typeLabel":"enum\u003cstring> | null"},"status":{"type":"string","enum":["lead","customer","churned"],"description":"Status of the contact, derived from its tenancies. `lead` means the contact has no tenancies, and is the default. `customer` means at least one tenancy hasn't ended. `churned` means all tenancies have ended.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.status","typeLabel":"enum\u003cstring>"},"stripe_customer_id":{"oneOf":[{"type":"string","deprecated":true,"description":"**Deprecated. Will be removed in a future API version.** Stripe Customer identifier of the contact. Kept for backwards compatibility. Don't use it in new integrations.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.stripe_customer_id.oneOf.0","typeLabel":"string"},{"type":"null","deprecated":true,"description":"**Deprecated. Will be removed in a future API version.** Stripe Customer identifier of the contact. Kept for backwards compatibility. Don't use it in new integrations.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.stripe_customer_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.contact.oneOf.0.stripe_customer_id","typeLabel":"string | null"},"tax_id":{"oneOf":[{"type":"string","description":"Tax identification number of the contact.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.tax_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Tax identification number of the contact.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.tax_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.contact.oneOf.0.tax_id","typeLabel":"string | null"},"tenancies_count":{"type":"integer","description":"Number of tenancies associated with the contact.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.tenancies_count","typeLabel":"integer"},"type":{"oneOf":[{"type":"string","enum":["domestic","company","student","charity","local_authority",null],"description":"Type of the contact.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["domestic","company","student","charity","local_authority",null],"description":"Type of the contact.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.type.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.contact.oneOf.0.type","typeLabel":"enum\u003cstring> | null"},"updated_at":{"type":"string","format":"date-time","description":"Last update date and time of the contact.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.updated_at","typeLabel":"string\u003cdate-time>"},"use_case":{"oneOf":[{"type":"string","enum":["business_needs","moving_home","more_space","refurb","travelling","other",null],"description":"Use case for the contact.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.use_case.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["business_needs","moving_home","more_space","refurb","travelling","other",null],"description":"Use case for the contact.","isRequired":true,"uniqueKey":"deal.contact.oneOf.0.use_case.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.contact.oneOf.0.use_case","typeLabel":"enum\u003cstring> | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.contact.oneOf.0","typeLabel":"object"},{"type":"object","description":"Contact associated with the deal. **Expandable** (shows only ID when not expanded).","required":["id"],"properties":{"id":{"type":"string","pattern":"^con_","description":"Unique identifier for the contact (`con_…`).","isRequired":true,"uniqueKey":"deal.contact.oneOf.1.id","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.contact.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"deal.contact","typeLabel":"object"},"created_at":{"type":"string","format":"date-time","description":"Creation date and time of the deal.","isRequired":true,"uniqueKey":"deal.created_at","typeLabel":"string\u003cdate-time>"},"creator":{"oneOf":[{"type":"object","description":"Creator of the deal. Can be Staff, Access Token or Application. **Expandable** (shows only ID when not expanded).","required":["id","created_at","email","name","updated_at"],"properties":{"id":{"type":"string","pattern":"^staff_","description":"Unique identifier for the staff member (`staff_…`).","isRequired":true,"uniqueKey":"deal.creator.oneOf.0.id","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","description":"Creation date and time of the staff.","isRequired":true,"uniqueKey":"deal.creator.oneOf.0.created_at","typeLabel":"string\u003cdate-time>"},"email":{"type":"string","format":"email","description":"Email address of the staff member.","isRequired":true,"uniqueKey":"deal.creator.oneOf.0.email","typeLabel":"string\u003cemail>"},"name":{"type":"string","description":"Full name of the staff member.","isRequired":true,"uniqueKey":"deal.creator.oneOf.0.name","typeLabel":"string"},"updated_at":{"type":"string","format":"date-time","description":"Last update date and time of the staff.","isRequired":true,"uniqueKey":"deal.creator.oneOf.0.updated_at","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.creator.oneOf.0","typeLabel":"object"},{"type":"object","description":"Creator of the deal. Can be Staff, Access Token or Application. **Expandable** (shows only ID when not expanded).","required":["id"],"properties":{"id":{"type":"string","pattern":"^staff_","description":"Unique identifier for the staff member (`staff_…`).","isRequired":true,"uniqueKey":"deal.creator.oneOf.1.id","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.creator.oneOf.1","typeLabel":"object"},{"type":"object","description":"Creator of the deal. Can be Staff, Access Token or Application. **Expandable** (shows only ID when not expanded).","required":["id","name"],"properties":{"id":{"type":"string","description":"Unique identifier for the access token or application.","isRequired":true,"uniqueKey":"deal.creator.oneOf.2.id","typeLabel":"string"},"name":{"type":"string","description":"Name of the access token or application.","isRequired":true,"uniqueKey":"deal.creator.oneOf.2.name","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.creator.oneOf.2","typeLabel":"object"},{"type":"object","description":"Creator of the deal. Can be Staff, Access Token or Application. **Expandable** (shows only ID when not expanded).","required":["id"],"properties":{"id":{"type":"string","description":"Unique identifier for the access token or application.","isRequired":true,"uniqueKey":"deal.creator.oneOf.3.id","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.creator.oneOf.3","typeLabel":"object"},{"type":"null","description":"Creator of the deal. Can be Staff, Access Token or Application. **Expandable** (shows only ID when not expanded).","isRequired":true,"uniqueKey":"deal.creator.oneOf.4","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.creator","typeLabel":"object · object · object · object · null"},"line_items":{"type":"array","items":{"type":"object","description":"Deal Line Item","required":["item","quantity","type"],"properties":{"item":{"oneOf":[{"type":"object","description":"Item associated with the line item. Can be a Unit type or Protection level. **Expandable** (shows only ID when not expanded).","required":["id","_links","created_at","dimensions","dynamic_pricing","images","live_prices","name","promotion","require_insurance_coverage","require_security_deposit","security_deposit","selling_points","size_description","slug","status","stripe_product_id","updated_at"],"properties":{"id":{"type":"string","pattern":"^utype_","description":"Unique identifier for the unit type (`utype_…`).","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.id","typeLabel":"string"},"_links":{"type":"object","additionalProperties":{"type":"object","additionalProperties":false,"properties":{"href":{"type":"string","description":"Relative path for API links, relative path for CURIE links.","uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0._links.additionalProperties.href","typeLabel":"string"},"method":{"type":"string","description":"Available only for API links. Other links use always `get`.","enum":["get","post","patch","delete"],"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0._links.additionalProperties.method","typeLabel":"enum\u003cstring>"},"title":{"type":"string","description":"Human-readable label for the link.","uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0._links.additionalProperties.title","typeLabel":"string"},"reference":{"oneOf":[{"type":"string","description":"OpenAPI reference for API links. Component schema for self links, path operation for action links.","uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0._links.additionalProperties.reference.oneOf.0","typeLabel":"string"},{"type":"null","description":"OpenAPI reference for API links. Component schema for self links, path operation for action links.","uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0._links.additionalProperties.reference.oneOf.1","typeLabel":"null"}],"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0._links.additionalProperties.reference","typeLabel":"string | null"}},"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0._links.additionalProperties","typeLabel":"object"},"description":"Links related to the resource.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0._links","typeLabel":"object"},"created_at":{"type":"string","format":"date-time","description":"Creation date and time for the unit type.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.created_at","typeLabel":"string\u003cdate-time>"},"dimensions":{"type":"object","description":"Dimensions of the unit type.","required":["height","length","measurement_unit","width"],"properties":{"height":{"type":"number","description":"Height of the unit type, in `measurement_unit`.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.dimensions.height","typeLabel":"number"},"length":{"type":"number","description":"Length of the unit type, in `measurement_unit`.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.dimensions.length","typeLabel":"number"},"measurement_unit":{"type":"string","enum":["ft","m"],"description":"Unit of length of the dimensions: `m` for metres or `ft` for feet.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.dimensions.measurement_unit","typeLabel":"enum\u003cstring>"},"width":{"type":"number","description":"Width of the unit type, in `measurement_unit`.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.dimensions.width","typeLabel":"number"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.dimensions","typeLabel":"object"},"dynamic_pricing":{"type":"boolean","description":"Indicates whether dynamic pricing is enabled for this unit type.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.dynamic_pricing","typeLabel":"boolean"},"images":{"type":"object","additionalProperties":false,"properties":{"default":{"oneOf":[{"type":"object","description":"The `default` image, or `null` when none is uploaded.","additionalProperties":false,"properties":{"original":{"type":"string","format":"uri","description":"Original unresized image.","uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.images.default.oneOf.0.original","typeLabel":"string\u003curi>"},"small":{"type":"string","format":"uri","description":"Resized to max 250x250px.","uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.images.default.oneOf.0.small","typeLabel":"string\u003curi>"},"medium":{"type":"string","format":"uri","description":"Resized to max 500x500px.","uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.images.default.oneOf.0.medium","typeLabel":"string\u003curi>"},"large":{"type":"string","format":"uri","description":"Resized to max 1000x1000px.","uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.images.default.oneOf.0.large","typeLabel":"string\u003curi>"}},"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.images.default.oneOf.0","typeLabel":"object"},{"type":"null","description":"The `default` image, or `null` when none is uploaded.","additionalProperties":false,"properties":{"original":{"type":"string","format":"uri","description":"Original unresized image."},"small":{"type":"string","format":"uri","description":"Resized to max 250x250px."},"medium":{"type":"string","format":"uri","description":"Resized to max 500x500px."},"large":{"type":"string","format":"uri","description":"Resized to max 1000x1000px."}},"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.images.default.oneOf.1","typeLabel":"null"}],"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.images.default","typeLabel":"object | null"}},"description":"Image URLs keyed by image name. Each URL redirects to a short-lived download link, so don't cache the redirect target.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.images","typeLabel":"object"},"live_prices":{"type":"array","items":{"type":"object","description":"Price","required":["billing_period","price","stripe_price_id"],"properties":{"billing_period":{"type":"string","enum":["monthly","weekly","every_four_weeks","every_three_months","every_six_months","yearly","one_time"],"description":"Billing period for the price.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.live_prices.items.[INDEX].billing_period","typeLabel":"enum\u003cstring>"},"price":{"type":"object","description":"Price for the specified billing period.","required":["amount","currency","formatted"],"properties":{"amount":{"type":"integer","description":"Amount of money in the smallest currency unit (e.g., cents for USD).","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.live_prices.items.[INDEX].price.amount","typeLabel":"integer"},"currency":{"type":"string","enum":["AED","AUD","BGN","BRL","CAD","CHF","CZK","DKK","EUR","GBP","HKD","HUF","MXN","MYR","NOK","NZD","PLN","RON","SEK","SGD","THB","USD"],"description":"ISO 4217 currency code.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.live_prices.items.[INDEX].price.currency","typeLabel":"enum\u003cstring>"},"formatted":{"type":"string","description":"Formatted string representation of the money amount, including the currency symbol.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.live_prices.items.[INDEX].price.formatted","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.live_prices.items.[INDEX].price","typeLabel":"object"},"stripe_price_id":{"oneOf":[{"type":"string","deprecated":true,"description":"**Deprecated — will be removed in a future API version.** Stripe Price ID associated with this price, used for payment processing. Retained for backwards compatibility; do not use in new integrations.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.live_prices.items.[INDEX].stripe_price_id.oneOf.0","typeLabel":"string"},{"type":"null","deprecated":true,"description":"**Deprecated — will be removed in a future API version.** Stripe Price ID associated with this price, used for payment processing. Retained for backwards compatibility; do not use in new integrations.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.live_prices.items.[INDEX].stripe_price_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.live_prices.items.[INDEX].stripe_price_id","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.live_prices.items.[INDEX]","typeLabel":"object"},"description":"Current source price used by storefront pricing. Returns the active dynamic price when one applies; otherwise returns the base storefront price. Promotions, discounts, and tax-exclusive variants are not applied.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.live_prices","typeLabel":"object[]"},"name":{"type":"string","description":"Name of the unit type.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.name","typeLabel":"string"},"promotion":{"oneOf":[{"type":"object","description":"Promotional coupon associated with the unit type. **Expandable** (shows only ID when not expanded).","required":["id","auto_apply_to","billing_period","code","created_at","duration","max_redemptions","months","name","public","title","type","updated_at"],"properties":{"id":{"type":"string","pattern":"^cpn_","description":"Unique identifier for the coupon (`cpn_…`).","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.id","typeLabel":"string"},"auto_apply_to":{"type":"object","description":"Line items the coupon is applied to automatically when used on an order.","required":["products","protections","subscriptions","unit_types"],"properties":{"products":{"type":"boolean","description":"Whether the coupon applies to product line items.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.auto_apply_to.products","typeLabel":"boolean"},"protections":{"type":"boolean","description":"Whether the coupon applies to protection line items.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.auto_apply_to.protections","typeLabel":"boolean"},"subscriptions":{"type":"boolean","description":"Whether the coupon applies to the subscription.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.auto_apply_to.subscriptions","typeLabel":"boolean"},"unit_types":{"type":"boolean","description":"Whether the coupon applies to unit type line items.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.auto_apply_to.unit_types","typeLabel":"boolean"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.auto_apply_to","typeLabel":"object"},"billing_period":{"oneOf":[{"type":"string","enum":["monthly","weekly","every_four_weeks","every_three_months","every_six_months","yearly","one_time",null],"description":"Used for `repeating` duration.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.billing_period.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["monthly","weekly","every_four_weeks","every_three_months","every_six_months","yearly","one_time",null],"description":"Used for `repeating` duration.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.billing_period.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.billing_period","typeLabel":"enum\u003cstring> | null"},"code":{"oneOf":[{"type":"string","description":"Unique code for the coupon for non-public coupons.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Unique code for the coupon for non-public coupons.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.code","typeLabel":"string | null"},"created_at":{"type":"string","format":"date-time","description":"Creation date and time of the coupon.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.created_at","typeLabel":"string\u003cdate-time>"},"duration":{"type":"string","enum":["once","forever","repeating"],"description":"Duration of the coupon.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.duration","typeLabel":"enum\u003cstring>"},"max_redemptions":{"oneOf":[{"type":"integer","description":"Maximum number of times the coupon can be redeemed.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.max_redemptions.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Maximum number of times the coupon can be redeemed.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.max_redemptions.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.max_redemptions","typeLabel":"integer | null"},"months":{"oneOf":[{"type":"integer","description":"Number of months the coupon is valid for, applicable for `repeating` duration.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.months.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Number of months the coupon is valid for, applicable for `repeating` duration.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.months.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.months","typeLabel":"integer | null"},"name":{"type":"string","description":"Name of the coupon.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.name","typeLabel":"string"},"public":{"type":"boolean","description":"Indicates if the coupon is publicly available for any contact to use. When set to `true`, the `code` field is not used.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.public","typeLabel":"boolean"},"title":{"oneOf":[{"type":"string","description":"Title of the coupon.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.title.oneOf.0","typeLabel":"string"},{"type":"null","description":"Title of the coupon.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.title","typeLabel":"string | null"},"type":{"type":"string","enum":["percentage","amount"],"description":"Type of the coupon.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.type","typeLabel":"enum\u003cstring>"},"updated_at":{"type":"string","format":"date-time","description":"Last update date and time of the coupon.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.updated_at","typeLabel":"string\u003cdate-time>"},"amount":{"type":"object","description":"Amount deducted from the price when the coupon is applied.","required":["amount","currency","formatted"],"properties":{"amount":{"type":"integer","description":"Amount of money in the smallest currency unit (e.g., cents for USD).","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.amount.amount","typeLabel":"integer"},"currency":{"type":"string","enum":["AED","AUD","BGN","BRL","CAD","CHF","CZK","DKK","EUR","GBP","HKD","HUF","MXN","MYR","NOK","NZD","PLN","RON","SEK","SGD","THB","USD"],"description":"ISO 4217 currency code.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.amount.currency","typeLabel":"enum\u003cstring>"},"formatted":{"type":"string","description":"Formatted string representation of the money amount, including the currency symbol.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.amount.formatted","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.amount","typeLabel":"object"},"percent":{"type":"number","description":"Percentage off the price, greater than 0 and at most 100, with up to 2 decimal places. `20` means 20% off.","uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0.percent","typeLabel":"number"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.0","typeLabel":"object"},{"type":"object","description":"Promotional coupon associated with the unit type. **Expandable** (shows only ID when not expanded).","required":["id"],"properties":{"id":{"type":"string","pattern":"^cpn_","description":"Unique identifier for the coupon (`cpn_…`).","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.1.id","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.1","typeLabel":"object"},{"type":"null","description":"Promotional coupon associated with the unit type. **Expandable** (shows only ID when not expanded).","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion.oneOf.2","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.promotion","typeLabel":"object · object · null"},"require_insurance_coverage":{"type":"boolean","description":"Indicates whether insurance coverage is required for this unit type.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.require_insurance_coverage","typeLabel":"boolean"},"require_security_deposit":{"type":"boolean","description":"Indicates whether a security deposit is required for this unit type.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.require_security_deposit","typeLabel":"boolean"},"security_deposit":{"oneOf":[{"type":"object","description":"Security deposit amount for the unit type.","required":["amount","currency","formatted"],"properties":{"amount":{"type":"integer","description":"Amount of money in the smallest currency unit (e.g., cents for USD).","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.security_deposit.oneOf.0.amount","typeLabel":"integer"},"currency":{"type":"string","enum":["AED","AUD","BGN","BRL","CAD","CHF","CZK","DKK","EUR","GBP","HKD","HUF","MXN","MYR","NOK","NZD","PLN","RON","SEK","SGD","THB","USD"],"description":"ISO 4217 currency code.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.security_deposit.oneOf.0.currency","typeLabel":"enum\u003cstring>"},"formatted":{"type":"string","description":"Formatted string representation of the money amount, including the currency symbol.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.security_deposit.oneOf.0.formatted","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.security_deposit.oneOf.0","typeLabel":"object"},{"type":"null","description":"Security deposit amount for the unit type.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.security_deposit.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.security_deposit","typeLabel":"object | null"},"selling_points":{"type":"array","items":{"type":"string","uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.selling_points.items.[INDEX]","typeLabel":"string"},"description":"List of selling points for the unit type.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.selling_points","typeLabel":"string[]"},"size_description":{"type":"string","description":"Description of the size of the unit type.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.size_description","typeLabel":"string"},"slug":{"type":"string","description":"URL-friendly identifier for the unit type, typically used in web addresses.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.slug","typeLabel":"string"},"status":{"type":"string","enum":["bookable","hidden","lead_capture"],"description":"Availability of the unit type on the storefront: `bookable`, `lead_capture` (collecting leads) or `hidden`.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.status","typeLabel":"enum\u003cstring>"},"stripe_product_id":{"oneOf":[{"type":"string","deprecated":true,"description":"**Deprecated — will be removed in a future API version.** Stripe Product ID associated with the unit type, used for payment processing. Retained for backwards compatibility; do not use in new integrations.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.stripe_product_id.oneOf.0","typeLabel":"string"},{"type":"null","deprecated":true,"description":"**Deprecated — will be removed in a future API version.** Stripe Product ID associated with the unit type, used for payment processing. Retained for backwards compatibility; do not use in new integrations.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.stripe_product_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.stripe_product_id","typeLabel":"string | null"},"updated_at":{"type":"string","format":"date-time","description":"Last update date and time for the unit type.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0.updated_at","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.0","typeLabel":"object"},{"type":"object","description":"Item associated with the line item. Can be a Unit type or Protection level. **Expandable** (shows only ID when not expanded).","required":["id"],"properties":{"id":{"type":"string","pattern":"^utype_","description":"Unique identifier for the unit type (`utype_…`).","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.1.id","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.1","typeLabel":"object"},{"type":"object","description":"Item associated with the line item. Can be a Unit type or Protection level. **Expandable** (shows only ID when not expanded).","required":["id","account_code","cover_level","created_at","public","site","stripe_product_id","updated_at"],"properties":{"id":{"type":"string","pattern":"^plvl_","description":"Unique identifier for the protection level (`plvl_…`).","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.id","typeLabel":"string"},"account_code":{"oneOf":[{"type":"string","description":"Account code associated with the protection level.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.account_code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Account code associated with the protection level.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.account_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.account_code","typeLabel":"string | null"},"cover_level":{"type":"object","description":"Monetary value representing the cover level of the protection.","required":["amount","currency","formatted"],"properties":{"amount":{"type":"integer","description":"Amount of money in the smallest currency unit (e.g., cents for USD).","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.cover_level.amount","typeLabel":"integer"},"currency":{"type":"string","enum":["AED","AUD","BGN","BRL","CAD","CHF","CZK","DKK","EUR","GBP","HKD","HUF","MXN","MYR","NOK","NZD","PLN","RON","SEK","SGD","THB","USD"],"description":"ISO 4217 currency code.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.cover_level.currency","typeLabel":"enum\u003cstring>"},"formatted":{"type":"string","description":"Formatted string representation of the money amount, including the currency symbol.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.cover_level.formatted","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.cover_level","typeLabel":"object"},"created_at":{"type":"string","format":"date-time","description":"Creation date and time of the protection level.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.created_at","typeLabel":"string\u003cdate-time>"},"public":{"type":"boolean","description":"Indicates whether the protection level is available for selection.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.public","typeLabel":"boolean"},"site":{"oneOf":[{"type":"object","description":"Site associated with the protection level. Returns `null` for global protection levels. **Expandable** (shows only ID when not expanded).","required":["id","access_hours","address","created_at","description","directions","images","name","opened_at","phone","updated_at"],"properties":{"id":{"type":"string","pattern":"^site_","description":"Unique identifier for the site (`site_…`).","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.id","typeLabel":"string"},"access_hours":{"oneOf":[{"type":"object","description":"Access hours for the site.","required":["friday","monday","saturday","sunday","thursday","tuesday","wednesday"],"properties":{"friday":{"type":"object","description":"Access Hours Day","required":["close","open","status"],"properties":{"close":{"oneOf":[{"type":"string","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.friday.close.oneOf.0","typeLabel":"string"},{"type":"null","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.friday.close.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.friday.close","typeLabel":"string | null"},"open":{"oneOf":[{"type":"string","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.friday.open.oneOf.0","typeLabel":"string"},{"type":"null","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.friday.open.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.friday.open","typeLabel":"string | null"},"status":{"type":"string","enum":["set_hours","appointment","closed"],"description":"Access on the day: `set_hours` between `open` and `close`, `appointment` by appointment only, or `closed`.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.friday.status","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.friday","typeLabel":"object"},"monday":{"type":"object","description":"Access Hours Day","required":["close","open","status"],"properties":{"close":{"oneOf":[{"type":"string","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.monday.close.oneOf.0","typeLabel":"string"},{"type":"null","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.monday.close.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.monday.close","typeLabel":"string | null"},"open":{"oneOf":[{"type":"string","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.monday.open.oneOf.0","typeLabel":"string"},{"type":"null","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.monday.open.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.monday.open","typeLabel":"string | null"},"status":{"type":"string","enum":["set_hours","appointment","closed"],"description":"Access on the day: `set_hours` between `open` and `close`, `appointment` by appointment only, or `closed`.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.monday.status","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.monday","typeLabel":"object"},"saturday":{"type":"object","description":"Access Hours Day","required":["close","open","status"],"properties":{"close":{"oneOf":[{"type":"string","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.saturday.close.oneOf.0","typeLabel":"string"},{"type":"null","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.saturday.close.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.saturday.close","typeLabel":"string | null"},"open":{"oneOf":[{"type":"string","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.saturday.open.oneOf.0","typeLabel":"string"},{"type":"null","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.saturday.open.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.saturday.open","typeLabel":"string | null"},"status":{"type":"string","enum":["set_hours","appointment","closed"],"description":"Access on the day: `set_hours` between `open` and `close`, `appointment` by appointment only, or `closed`.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.saturday.status","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.saturday","typeLabel":"object"},"sunday":{"type":"object","description":"Access Hours Day","required":["close","open","status"],"properties":{"close":{"oneOf":[{"type":"string","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.sunday.close.oneOf.0","typeLabel":"string"},{"type":"null","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.sunday.close.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.sunday.close","typeLabel":"string | null"},"open":{"oneOf":[{"type":"string","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.sunday.open.oneOf.0","typeLabel":"string"},{"type":"null","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.sunday.open.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.sunday.open","typeLabel":"string | null"},"status":{"type":"string","enum":["set_hours","appointment","closed"],"description":"Access on the day: `set_hours` between `open` and `close`, `appointment` by appointment only, or `closed`.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.sunday.status","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.sunday","typeLabel":"object"},"thursday":{"type":"object","description":"Access Hours Day","required":["close","open","status"],"properties":{"close":{"oneOf":[{"type":"string","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.thursday.close.oneOf.0","typeLabel":"string"},{"type":"null","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.thursday.close.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.thursday.close","typeLabel":"string | null"},"open":{"oneOf":[{"type":"string","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.thursday.open.oneOf.0","typeLabel":"string"},{"type":"null","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.thursday.open.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.thursday.open","typeLabel":"string | null"},"status":{"type":"string","enum":["set_hours","appointment","closed"],"description":"Access on the day: `set_hours` between `open` and `close`, `appointment` by appointment only, or `closed`.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.thursday.status","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.thursday","typeLabel":"object"},"tuesday":{"type":"object","description":"Access Hours Day","required":["close","open","status"],"properties":{"close":{"oneOf":[{"type":"string","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.tuesday.close.oneOf.0","typeLabel":"string"},{"type":"null","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.tuesday.close.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.tuesday.close","typeLabel":"string | null"},"open":{"oneOf":[{"type":"string","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.tuesday.open.oneOf.0","typeLabel":"string"},{"type":"null","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.tuesday.open.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.tuesday.open","typeLabel":"string | null"},"status":{"type":"string","enum":["set_hours","appointment","closed"],"description":"Access on the day: `set_hours` between `open` and `close`, `appointment` by appointment only, or `closed`.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.tuesday.status","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.tuesday","typeLabel":"object"},"wednesday":{"type":"object","description":"Access Hours Day","required":["close","open","status"],"properties":{"close":{"oneOf":[{"type":"string","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.wednesday.close.oneOf.0","typeLabel":"string"},{"type":"null","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.wednesday.close.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.wednesday.close","typeLabel":"string | null"},"open":{"oneOf":[{"type":"string","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.wednesday.open.oneOf.0","typeLabel":"string"},{"type":"null","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.wednesday.open.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.wednesday.open","typeLabel":"string | null"},"status":{"type":"string","enum":["set_hours","appointment","closed"],"description":"Access on the day: `set_hours` between `open` and `close`, `appointment` by appointment only, or `closed`.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.wednesday.status","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0.wednesday","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.0","typeLabel":"object"},{"type":"null","description":"Access hours for the site.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.access_hours","typeLabel":"object | null"},"address":{"oneOf":[{"type":"object","description":"Address of the site.","required":["city","line_1","line_2","postal_code"],"properties":{"city":{"oneOf":[{"type":"string","description":"City of the site.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.address.oneOf.0.city.oneOf.0","typeLabel":"string"},{"type":"null","description":"City of the site.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.address.oneOf.0.city.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.address.oneOf.0.city","typeLabel":"string | null"},"line_1":{"oneOf":[{"type":"string","description":"First line of the address.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.address.oneOf.0.line_1.oneOf.0","typeLabel":"string"},{"type":"null","description":"First line of the address.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.address.oneOf.0.line_1.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.address.oneOf.0.line_1","typeLabel":"string | null"},"line_2":{"oneOf":[{"type":"string","description":"Second line of the address (optional).","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.address.oneOf.0.line_2.oneOf.0","typeLabel":"string"},{"type":"null","description":"Second line of the address (optional).","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.address.oneOf.0.line_2.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.address.oneOf.0.line_2","typeLabel":"string | null"},"postal_code":{"oneOf":[{"type":"string","description":"Postal code of the site.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.address.oneOf.0.postal_code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Postal code of the site.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.address.oneOf.0.postal_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.address.oneOf.0.postal_code","typeLabel":"string | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.address.oneOf.0","typeLabel":"object"},{"type":"null","description":"Address of the site.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.address.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.address","typeLabel":"object | null"},"created_at":{"type":"string","format":"date-time","description":"Creation date and time of the site.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.created_at","typeLabel":"string\u003cdate-time>"},"description":{"oneOf":[{"type":"string","description":"Description of the site.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Description of the site.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.description","typeLabel":"string | null"},"directions":{"type":"object","description":"Directions to the site.","required":["google_maps_url"],"properties":{"google_maps_url":{"oneOf":[{"type":"string","description":"URL to Google Maps for the site.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.directions.google_maps_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL to Google Maps for the site.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.directions.google_maps_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.directions.google_maps_url","typeLabel":"string | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.directions","typeLabel":"object"},"images":{"type":"object","additionalProperties":false,"properties":{"default":{"oneOf":[{"type":"object","description":"The `default` image, or `null` when none is uploaded.","additionalProperties":false,"properties":{"original":{"type":"string","format":"uri","description":"Original unresized image.","uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.images.default.oneOf.0.original","typeLabel":"string\u003curi>"},"small":{"type":"string","format":"uri","description":"Resized to max 250x250px.","uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.images.default.oneOf.0.small","typeLabel":"string\u003curi>"},"medium":{"type":"string","format":"uri","description":"Resized to max 500x500px.","uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.images.default.oneOf.0.medium","typeLabel":"string\u003curi>"},"large":{"type":"string","format":"uri","description":"Resized to max 1000x1000px.","uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.images.default.oneOf.0.large","typeLabel":"string\u003curi>"}},"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.images.default.oneOf.0","typeLabel":"object"},{"type":"null","description":"The `default` image, or `null` when none is uploaded.","additionalProperties":false,"properties":{"original":{"type":"string","format":"uri","description":"Original unresized image."},"small":{"type":"string","format":"uri","description":"Resized to max 250x250px."},"medium":{"type":"string","format":"uri","description":"Resized to max 500x500px."},"large":{"type":"string","format":"uri","description":"Resized to max 1000x1000px."}},"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.images.default.oneOf.1","typeLabel":"null"}],"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.images.default","typeLabel":"object | null"}},"description":"Image URLs keyed by image name. Each URL redirects to a short-lived download link, so don't cache the redirect target.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.images","typeLabel":"object"},"name":{"type":"string","description":"Name of the site.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.name","typeLabel":"string"},"opened_at":{"oneOf":[{"type":"string","format":"date-time","description":"Date and time when the site opened or will open.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.opened_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Date and time when the site opened or will open.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.opened_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.opened_at","typeLabel":"string\u003cdate-time> | null"},"phone":{"oneOf":[{"type":"string","description":"Phone number of the site.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.phone.oneOf.0","typeLabel":"string"},{"type":"null","description":"Phone number of the site.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.phone.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.phone","typeLabel":"string | null"},"updated_at":{"type":"string","format":"date-time","description":"Last update date and time of the site.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0.updated_at","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.0","typeLabel":"object"},{"type":"object","description":"Site associated with the protection level. Returns `null` for global protection levels. **Expandable** (shows only ID when not expanded).","required":["id"],"properties":{"id":{"type":"string","pattern":"^site_","description":"Unique identifier for the site (`site_…`).","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.1.id","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.1","typeLabel":"object"},{"type":"null","description":"Site associated with the protection level. Returns `null` for global protection levels. **Expandable** (shows only ID when not expanded).","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site.oneOf.2","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.site","typeLabel":"object · object · null"},"stripe_product_id":{"oneOf":[{"type":"string","deprecated":true,"description":"**Deprecated — will be removed in a future API version.** Stripe Product ID associated with the protection level, used for payment processing. Retained for backwards compatibility; do not use in new integrations.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.stripe_product_id.oneOf.0","typeLabel":"string"},{"type":"null","deprecated":true,"description":"**Deprecated — will be removed in a future API version.** Stripe Product ID associated with the protection level, used for payment processing. Retained for backwards compatibility; do not use in new integrations.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.stripe_product_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.stripe_product_id","typeLabel":"string | null"},"updated_at":{"type":"string","format":"date-time","description":"Last update date and time of the protection level.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2.updated_at","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.2","typeLabel":"object"},{"type":"object","description":"Item associated with the line item. Can be a Unit type or Protection level. **Expandable** (shows only ID when not expanded).","required":["id"],"properties":{"id":{"type":"string","pattern":"^plvl_","description":"Unique identifier for the protection level (`plvl_…`).","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.3.id","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item.oneOf.3","typeLabel":"object"}],"isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].item","typeLabel":"object"},"quantity":{"type":"integer","description":"Quantity of the item in the deal line item.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].quantity","typeLabel":"integer"},"type":{"type":"string","enum":["unit_type","protection"],"description":"The kind of line item.","isRequired":true,"uniqueKey":"deal.line_items.items.[INDEX].type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"deal.line_items.items.[INDEX]","typeLabel":"object"},"description":"List of line items associated with the deal. Each item references either a unit type or a protection level.","isRequired":true,"uniqueKey":"deal.line_items","typeLabel":"object[]"},"lost_reason":{"oneOf":[{"type":"string","enum":["accessibility_concern","better_deal_elsewhere","chose_competitor","contract_terms","decided_not_to_use_storage","didnt_respond","due_to_unstaffed_site","facility_condition","financial_reasons","lack_of_response","location_issues","needs_extra_services","no_longer_needed","poor_customer_service","price_concerns","security_concerns","size_availability","timing","unable_to_reach_customer","unable_to_take_deliveries","other",null],"description":"Reason for loss of deal if lost.","isRequired":true,"uniqueKey":"deal.lost_reason.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["accessibility_concern","better_deal_elsewhere","chose_competitor","contract_terms","decided_not_to_use_storage","didnt_respond","due_to_unstaffed_site","facility_condition","financial_reasons","lack_of_response","location_issues","needs_extra_services","no_longer_needed","poor_customer_service","price_concerns","security_concerns","size_availability","timing","unable_to_reach_customer","unable_to_take_deliveries","other",null],"description":"Reason for loss of deal if lost.","isRequired":true,"uniqueKey":"deal.lost_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.lost_reason","typeLabel":"enum\u003cstring> | null"},"metadata":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"deal.metadata.additionalProperties","typeLabel":"string"},"maxProperties":20,"description":"Set of key-value pairs for storing additional information. [Learn more about metadata.](https://docs.stora.co/2025-09/guides/metadata)","isRequired":true,"uniqueKey":"deal.metadata","typeLabel":"object"},"name":{"type":"string","description":"Name of the deal.","isRequired":true,"uniqueKey":"deal.name","typeLabel":"string"},"note":{"oneOf":[{"type":"string","description":"Free-text note for the deal. Displayed under 'Deal value estimate' in Backoffice.","isRequired":true,"uniqueKey":"deal.note.oneOf.0","typeLabel":"string"},{"type":"null","description":"Free-text note for the deal. Displayed under 'Deal value estimate' in Backoffice.","isRequired":true,"uniqueKey":"deal.note.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.note","typeLabel":"string | null"},"site":{"oneOf":[{"type":"object","description":"Site associated with the deal. **Expandable** (shows only ID when not expanded).","required":["id","access_hours","address","created_at","description","directions","images","name","opened_at","phone","updated_at"],"properties":{"id":{"type":"string","pattern":"^site_","description":"Unique identifier for the site (`site_…`).","isRequired":true,"uniqueKey":"deal.site.oneOf.0.id","typeLabel":"string"},"access_hours":{"oneOf":[{"type":"object","description":"Access hours for the site.","required":["friday","monday","saturday","sunday","thursday","tuesday","wednesday"],"properties":{"friday":{"type":"object","description":"Access Hours Day","required":["close","open","status"],"properties":{"close":{"oneOf":[{"type":"string","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.friday.close.oneOf.0","typeLabel":"string"},{"type":"null","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.friday.close.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.friday.close","typeLabel":"string | null"},"open":{"oneOf":[{"type":"string","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.friday.open.oneOf.0","typeLabel":"string"},{"type":"null","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.friday.open.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.friday.open","typeLabel":"string | null"},"status":{"type":"string","enum":["set_hours","appointment","closed"],"description":"Access on the day: `set_hours` between `open` and `close`, `appointment` by appointment only, or `closed`.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.friday.status","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.friday","typeLabel":"object"},"monday":{"type":"object","description":"Access Hours Day","required":["close","open","status"],"properties":{"close":{"oneOf":[{"type":"string","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.monday.close.oneOf.0","typeLabel":"string"},{"type":"null","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.monday.close.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.monday.close","typeLabel":"string | null"},"open":{"oneOf":[{"type":"string","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.monday.open.oneOf.0","typeLabel":"string"},{"type":"null","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.monday.open.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.monday.open","typeLabel":"string | null"},"status":{"type":"string","enum":["set_hours","appointment","closed"],"description":"Access on the day: `set_hours` between `open` and `close`, `appointment` by appointment only, or `closed`.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.monday.status","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.monday","typeLabel":"object"},"saturday":{"type":"object","description":"Access Hours Day","required":["close","open","status"],"properties":{"close":{"oneOf":[{"type":"string","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.saturday.close.oneOf.0","typeLabel":"string"},{"type":"null","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.saturday.close.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.saturday.close","typeLabel":"string | null"},"open":{"oneOf":[{"type":"string","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.saturday.open.oneOf.0","typeLabel":"string"},{"type":"null","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.saturday.open.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.saturday.open","typeLabel":"string | null"},"status":{"type":"string","enum":["set_hours","appointment","closed"],"description":"Access on the day: `set_hours` between `open` and `close`, `appointment` by appointment only, or `closed`.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.saturday.status","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.saturday","typeLabel":"object"},"sunday":{"type":"object","description":"Access Hours Day","required":["close","open","status"],"properties":{"close":{"oneOf":[{"type":"string","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.sunday.close.oneOf.0","typeLabel":"string"},{"type":"null","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.sunday.close.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.sunday.close","typeLabel":"string | null"},"open":{"oneOf":[{"type":"string","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.sunday.open.oneOf.0","typeLabel":"string"},{"type":"null","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.sunday.open.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.sunday.open","typeLabel":"string | null"},"status":{"type":"string","enum":["set_hours","appointment","closed"],"description":"Access on the day: `set_hours` between `open` and `close`, `appointment` by appointment only, or `closed`.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.sunday.status","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.sunday","typeLabel":"object"},"thursday":{"type":"object","description":"Access Hours Day","required":["close","open","status"],"properties":{"close":{"oneOf":[{"type":"string","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.thursday.close.oneOf.0","typeLabel":"string"},{"type":"null","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.thursday.close.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.thursday.close","typeLabel":"string | null"},"open":{"oneOf":[{"type":"string","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.thursday.open.oneOf.0","typeLabel":"string"},{"type":"null","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.thursday.open.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.thursday.open","typeLabel":"string | null"},"status":{"type":"string","enum":["set_hours","appointment","closed"],"description":"Access on the day: `set_hours` between `open` and `close`, `appointment` by appointment only, or `closed`.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.thursday.status","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.thursday","typeLabel":"object"},"tuesday":{"type":"object","description":"Access Hours Day","required":["close","open","status"],"properties":{"close":{"oneOf":[{"type":"string","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.tuesday.close.oneOf.0","typeLabel":"string"},{"type":"null","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.tuesday.close.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.tuesday.close","typeLabel":"string | null"},"open":{"oneOf":[{"type":"string","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.tuesday.open.oneOf.0","typeLabel":"string"},{"type":"null","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.tuesday.open.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.tuesday.open","typeLabel":"string | null"},"status":{"type":"string","enum":["set_hours","appointment","closed"],"description":"Access on the day: `set_hours` between `open` and `close`, `appointment` by appointment only, or `closed`.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.tuesday.status","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.tuesday","typeLabel":"object"},"wednesday":{"type":"object","description":"Access Hours Day","required":["close","open","status"],"properties":{"close":{"oneOf":[{"type":"string","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.wednesday.close.oneOf.0","typeLabel":"string"},{"type":"null","description":"Closing time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.wednesday.close.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.wednesday.close","typeLabel":"string | null"},"open":{"oneOf":[{"type":"string","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.wednesday.open.oneOf.0","typeLabel":"string"},{"type":"null","description":"Opening time in 24-hour `HH:MM` format. Has `null` for `appointment` or `closed` status.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.wednesday.open.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.wednesday.open","typeLabel":"string | null"},"status":{"type":"string","enum":["set_hours","appointment","closed"],"description":"Access on the day: `set_hours` between `open` and `close`, `appointment` by appointment only, or `closed`.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.wednesday.status","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0.wednesday","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.0","typeLabel":"object"},{"type":"null","description":"Access hours for the site.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.access_hours","typeLabel":"object | null"},"address":{"oneOf":[{"type":"object","description":"Address of the site.","required":["city","line_1","line_2","postal_code"],"properties":{"city":{"oneOf":[{"type":"string","description":"City of the site.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.address.oneOf.0.city.oneOf.0","typeLabel":"string"},{"type":"null","description":"City of the site.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.address.oneOf.0.city.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.address.oneOf.0.city","typeLabel":"string | null"},"line_1":{"oneOf":[{"type":"string","description":"First line of the address.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.address.oneOf.0.line_1.oneOf.0","typeLabel":"string"},{"type":"null","description":"First line of the address.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.address.oneOf.0.line_1.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.address.oneOf.0.line_1","typeLabel":"string | null"},"line_2":{"oneOf":[{"type":"string","description":"Second line of the address (optional).","isRequired":true,"uniqueKey":"deal.site.oneOf.0.address.oneOf.0.line_2.oneOf.0","typeLabel":"string"},{"type":"null","description":"Second line of the address (optional).","isRequired":true,"uniqueKey":"deal.site.oneOf.0.address.oneOf.0.line_2.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.address.oneOf.0.line_2","typeLabel":"string | null"},"postal_code":{"oneOf":[{"type":"string","description":"Postal code of the site.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.address.oneOf.0.postal_code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Postal code of the site.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.address.oneOf.0.postal_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.address.oneOf.0.postal_code","typeLabel":"string | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.site.oneOf.0.address.oneOf.0","typeLabel":"object"},{"type":"null","description":"Address of the site.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.address.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.address","typeLabel":"object | null"},"created_at":{"type":"string","format":"date-time","description":"Creation date and time of the site.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.created_at","typeLabel":"string\u003cdate-time>"},"description":{"oneOf":[{"type":"string","description":"Description of the site.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Description of the site.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.description","typeLabel":"string | null"},"directions":{"type":"object","description":"Directions to the site.","required":["google_maps_url"],"properties":{"google_maps_url":{"oneOf":[{"type":"string","description":"URL to Google Maps for the site.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.directions.google_maps_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL to Google Maps for the site.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.directions.google_maps_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.directions.google_maps_url","typeLabel":"string | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.site.oneOf.0.directions","typeLabel":"object"},"images":{"type":"object","additionalProperties":false,"properties":{"default":{"oneOf":[{"type":"object","description":"The `default` image, or `null` when none is uploaded.","additionalProperties":false,"properties":{"original":{"type":"string","format":"uri","description":"Original unresized image.","uniqueKey":"deal.site.oneOf.0.images.default.oneOf.0.original","typeLabel":"string\u003curi>"},"small":{"type":"string","format":"uri","description":"Resized to max 250x250px.","uniqueKey":"deal.site.oneOf.0.images.default.oneOf.0.small","typeLabel":"string\u003curi>"},"medium":{"type":"string","format":"uri","description":"Resized to max 500x500px.","uniqueKey":"deal.site.oneOf.0.images.default.oneOf.0.medium","typeLabel":"string\u003curi>"},"large":{"type":"string","format":"uri","description":"Resized to max 1000x1000px.","uniqueKey":"deal.site.oneOf.0.images.default.oneOf.0.large","typeLabel":"string\u003curi>"}},"uniqueKey":"deal.site.oneOf.0.images.default.oneOf.0","typeLabel":"object"},{"type":"null","description":"The `default` image, or `null` when none is uploaded.","additionalProperties":false,"properties":{"original":{"type":"string","format":"uri","description":"Original unresized image."},"small":{"type":"string","format":"uri","description":"Resized to max 250x250px."},"medium":{"type":"string","format":"uri","description":"Resized to max 500x500px."},"large":{"type":"string","format":"uri","description":"Resized to max 1000x1000px."}},"uniqueKey":"deal.site.oneOf.0.images.default.oneOf.1","typeLabel":"null"}],"uniqueKey":"deal.site.oneOf.0.images.default","typeLabel":"object | null"}},"description":"Image URLs keyed by image name. Each URL redirects to a short-lived download link, so don't cache the redirect target.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.images","typeLabel":"object"},"name":{"type":"string","description":"Name of the site.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.name","typeLabel":"string"},"opened_at":{"oneOf":[{"type":"string","format":"date-time","description":"Date and time when the site opened or will open.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.opened_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Date and time when the site opened or will open.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.opened_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.opened_at","typeLabel":"string\u003cdate-time> | null"},"phone":{"oneOf":[{"type":"string","description":"Phone number of the site.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.phone.oneOf.0","typeLabel":"string"},{"type":"null","description":"Phone number of the site.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.phone.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site.oneOf.0.phone","typeLabel":"string | null"},"updated_at":{"type":"string","format":"date-time","description":"Last update date and time of the site.","isRequired":true,"uniqueKey":"deal.site.oneOf.0.updated_at","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.site.oneOf.0","typeLabel":"object"},{"type":"object","description":"Site associated with the deal. **Expandable** (shows only ID when not expanded).","required":["id"],"properties":{"id":{"type":"string","pattern":"^site_","description":"Unique identifier for the site (`site_…`).","isRequired":true,"uniqueKey":"deal.site.oneOf.1.id","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.site.oneOf.1","typeLabel":"object"},{"type":"null","description":"Site associated with the deal. **Expandable** (shows only ID when not expanded).","isRequired":true,"uniqueKey":"deal.site.oneOf.2","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.site","typeLabel":"object · object · null"},"stage":{"oneOf":[{"type":"object","description":"Stage that the deal is currently in. **Expandable** (shows only ID when not expanded). Shows stage data with id omitted if the stage is deleted, noted by `- (Deleted)` in the `name` field.","required":["created_at","name","position","updated_at"],"properties":{"created_at":{"type":"string","format":"date-time","description":"Creation date and time of the stage.","isRequired":true,"uniqueKey":"deal.stage.oneOf.0.created_at","typeLabel":"string\u003cdate-time>"},"name":{"type":"string","description":"Name of the stage. A deleted stage has ` - (Deleted)` appended.","isRequired":true,"uniqueKey":"deal.stage.oneOf.0.name","typeLabel":"string"},"position":{"type":"integer","description":"Numerical position in which the stage is placed in the defined deal journey.","isRequired":true,"uniqueKey":"deal.stage.oneOf.0.position","typeLabel":"integer"},"updated_at":{"type":"string","format":"date-time","description":"Last update date and time of the stage.","isRequired":true,"uniqueKey":"deal.stage.oneOf.0.updated_at","typeLabel":"string\u003cdate-time>"},"id":{"type":"string","pattern":"^dstg_","description":"Unique identifier for the stage (`dstg_…`).","uniqueKey":"deal.stage.oneOf.0.id","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.stage.oneOf.0","typeLabel":"object"},{"type":"object","description":"Stage that the deal is currently in. **Expandable** (shows only ID when not expanded). Shows stage data with id omitted if the stage is deleted, noted by `- (Deleted)` in the `name` field.","required":["id"],"properties":{"id":{"type":"string","pattern":"^dstg_","description":"Unique identifier for the stage (`dstg_…`).","isRequired":true,"uniqueKey":"deal.stage.oneOf.1.id","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal.stage.oneOf.1","typeLabel":"object"},{"type":"null","description":"Stage that the deal is currently in. **Expandable** (shows only ID when not expanded). Shows stage data with id omitted if the stage is deleted, noted by `- (Deleted)` in the `name` field.","isRequired":true,"uniqueKey":"deal.stage.oneOf.2","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.stage","typeLabel":"object · object · null"},"starts_at":{"oneOf":[{"type":"string","format":"date-time","description":"Intended move-in date, as an ISO 8601 date-time at midnight UTC. Only the date is meaningful.","isRequired":true,"uniqueKey":"deal.starts_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Intended move-in date, as an ISO 8601 date-time at midnight UTC. Only the date is meaningful.","isRequired":true,"uniqueKey":"deal.starts_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.starts_at","typeLabel":"string\u003cdate-time> | null"},"status":{"type":"string","enum":["open","won","lost"],"description":"Status of the deal.","isRequired":true,"uniqueKey":"deal.status","typeLabel":"enum\u003cstring>"},"updated_at":{"type":"string","format":"date-time","description":"Last update date and time of the deal.","isRequired":true,"uniqueKey":"deal.updated_at","typeLabel":"string\u003cdate-time>"},"value_estimate":{"oneOf":[{"type":"string","deprecated":true,"description":"**Deprecated. Will be removed. Use `note` instead.** Estimate of the total value of this deal to the operator. It can cover storage fees alone, or storage, protection and any other services in the deal combined.","isRequired":true,"uniqueKey":"deal.value_estimate.oneOf.0","typeLabel":"string"},{"type":"null","deprecated":true,"description":"**Deprecated. Will be removed. Use `note` instead.** Estimate of the total value of this deal to the operator. It can cover storage fees alone, or storage, protection and any other services in the deal combined.","isRequired":true,"uniqueKey":"deal.value_estimate.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal.value_estimate","typeLabel":"string | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deal","typeLabel":"object"},"meta":{"type":"object","required":["curies","request_id"],"properties":{"curies":{"type":"array","items":{"type":"object","description":"CURIE definition for resolving namespaced link relations.","required":["href","name","templated","title"],"properties":{"href":{"type":"string","description":"URI template for resolving the CURIE.","isRequired":true,"uniqueKey":"meta.curies.items.[INDEX].href","typeLabel":"string"},"name":{"type":"string","enum":["bo","sf"],"description":"CURIE prefix name","isRequired":true,"uniqueKey":"meta.curies.items.[INDEX].name","typeLabel":"enum\u003cstring>"},"templated":{"type":"boolean","description":"Whether the href is a URI template.","isRequired":true,"uniqueKey":"meta.curies.items.[INDEX].templated","typeLabel":"boolean"},"title":{"type":"string","description":"Human-readable title.","isRequired":true,"uniqueKey":"meta.curies.items.[INDEX].title","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"meta.curies.items.[INDEX]","typeLabel":"object"},"description":"CURIE definitions for resolving namespaced link relations.","isRequired":true,"uniqueKey":"meta.curies","typeLabel":"object[]"},"request_id":{"type":"string","description":"Unique request identifier.","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"meta","typeLabel":"object"}},"additionalProperties":false,"description":"Single Deal","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"c015b632-a19a-4ab5-9aea-c7ff14d986e8":{"description":"opportunity not found","content":{"application/json":{"examples":{"default":{"title":"default","summary":"opportunity not found","value":{"error":{"code":"resource_not_found","details":[],"links":[{"kind":"api_reference","name":"Create a Deal from an Opportunity","url":"https://docs.stora.test/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity"},{"kind":"documentation","name":"Opportunities and deals","url":"https://docs.stora.test/2025-09/guides/opportunities-and-deals"},{"kind":"open_api","name":"OpenAPI specification","url":"https://docs.stora.test/2025-09/openapi.json"},{"kind":"documentation","name":"Errors","url":"https://docs.stora.test/2025-09/guides/errors#resource_not_found"}],"message":"The Opportunity was not found.","request_id":"01563646-58c1-4607-8fe0-cae3e92c4477","type":"invalid_request_error"}}}},"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"Error","required":["code","details","links","message","request_id","type"],"properties":{"code":{"type":"string","description":"Short code that represents the error.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","description":"ErrorDetail","required":["message","pointer"],"properties":{"message":{"type":"string","description":"Human-readable message providing detailed information about the error.","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"},"pointer":{"oneOf":[{"type":"string","description":"Points to the request field that caused the error:\n- String starting with '/': Exact path of the problematic field.\n- String starting without '/': General hint, cannot pinpoint exact field.\n- null: Error cannot be mapped to any specific field.\n","isRequired":true,"uniqueKey":"error.details.items.[INDEX].pointer.oneOf.0","typeLabel":"string"},{"type":"null","description":"Points to the request field that caused the error:\n- String starting with '/': Exact path of the problematic field.\n- String starting without '/': General hint, cannot pinpoint exact field.\n- null: Error cannot be mapped to any specific field.\n","isRequired":true,"uniqueKey":"error.details.items.[INDEX].pointer.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].pointer","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"description":"Array of error details.","isRequired":true,"uniqueKey":"error.details","typeLabel":"object[]"},"links":{"type":"array","items":{"type":"object","description":"Link to Stora developer resources","required":["kind","name","url"],"properties":{"kind":{"type":"string","description":"Kind of Stora documentation","isRequired":true,"uniqueKey":"error.links.items.[INDEX].kind","typeLabel":"string"},"name":{"type":"string","description":"Name of Stora documentation","isRequired":true,"uniqueKey":"error.links.items.[INDEX].name","typeLabel":"string"},"url":{"type":"string","format":"uri","description":"URL to Stora documentation","isRequired":true,"uniqueKey":"error.links.items.[INDEX].url","typeLabel":"string\u003curi>"}},"additionalProperties":false,"uniqueKey":"error.links.items.[INDEX]","typeLabel":"object"},"description":"Link(s) to Stora developer resources","isRequired":true,"uniqueKey":"error.links","typeLabel":"object[]"},"message":{"type":"string","description":"Human-readable message providing brief information about the error.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Unique request identifier.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"type":{"type":"string","enum":["invalid_request_error","api_error"],"description":"Type of error returned.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"description":"Error","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"cd070215-2e00-4194-a38c-47de8f4ae068":{"description":"opportunity already associated with a deal","content":{"application/json":{"examples":{"opportunity_converted":{"title":"opportunity_converted","summary":"opportunity already converted to a deal","value":{"error":{"code":"opportunity_converted","details":[],"links":[{"kind":"api_reference","name":"Create a Deal from an Opportunity","url":"https://docs.stora.test/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity"},{"kind":"documentation","name":"Opportunities and deals","url":"https://docs.stora.test/2025-09/guides/opportunities-and-deals"},{"kind":"open_api","name":"OpenAPI specification","url":"https://docs.stora.test/2025-09/openapi.json"},{"kind":"documentation","name":"Errors","url":"https://docs.stora.test/2025-09/guides/errors#opportunity_converted"}],"message":"The opportunity has already been converted to a deal.","request_id":"01563646-58c1-4607-8fe0-cae3e92c4477","type":"invalid_request_error"}}},"opportunity_not_convertible":{"title":"opportunity_not_convertible","summary":"unit type belongs to another site","value":{"error":{"code":"opportunity_not_convertible","details":[],"links":[{"kind":"api_reference","name":"Create a Deal from an Opportunity","url":"https://docs.stora.test/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity"},{"kind":"documentation","name":"Opportunities and deals","url":"https://docs.stora.test/2025-09/guides/opportunities-and-deals"},{"kind":"open_api","name":"OpenAPI specification","url":"https://docs.stora.test/2025-09/openapi.json"},{"kind":"documentation","name":"Errors","url":"https://docs.stora.test/2025-09/guides/errors#opportunity_not_convertible"}],"message":"The opportunity cannot be converted to a deal because its line items do not belong to its site. Update the opportunity and try again.","request_id":"01563646-58c1-4607-8fe0-cae3e92c4477","type":"invalid_request_error"}}},"default":{"title":"default","summary":"opportunity already associated with a deal","value":{"error":{"code":"opportunity_associated","details":[],"links":[{"kind":"api_reference","name":"Create a Deal from an Opportunity","url":"https://docs.stora.test/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity"},{"kind":"documentation","name":"Opportunities and deals","url":"https://docs.stora.test/2025-09/guides/opportunities-and-deals"},{"kind":"open_api","name":"OpenAPI specification","url":"https://docs.stora.test/2025-09/openapi.json"},{"kind":"documentation","name":"Errors","url":"https://docs.stora.test/2025-09/guides/errors#opportunity_associated"}],"message":"The opportunity is already associated with a deal.","request_id":"01563646-58c1-4607-8fe0-cae3e92c4477","type":"invalid_request_error"}}}},"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"Error","required":["code","details","links","message","request_id","type"],"properties":{"code":{"type":"string","description":"Short code that represents the error.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","description":"ErrorDetail","required":["message","pointer"],"properties":{"message":{"type":"string","description":"Human-readable message providing detailed information about the error.","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"},"pointer":{"oneOf":[{"type":"string","description":"Points to the request field that caused the error:\n- String starting with '/': Exact path of the problematic field.\n- String starting without '/': General hint, cannot pinpoint exact field.\n- null: Error cannot be mapped to any specific field.\n","isRequired":true,"uniqueKey":"error.details.items.[INDEX].pointer.oneOf.0","typeLabel":"string"},{"type":"null","description":"Points to the request field that caused the error:\n- String starting with '/': Exact path of the problematic field.\n- String starting without '/': General hint, cannot pinpoint exact field.\n- null: Error cannot be mapped to any specific field.\n","isRequired":true,"uniqueKey":"error.details.items.[INDEX].pointer.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].pointer","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"description":"Array of error details.","isRequired":true,"uniqueKey":"error.details","typeLabel":"object[]"},"links":{"type":"array","items":{"type":"object","description":"Link to Stora developer resources","required":["kind","name","url"],"properties":{"kind":{"type":"string","description":"Kind of Stora documentation","isRequired":true,"uniqueKey":"error.links.items.[INDEX].kind","typeLabel":"string"},"name":{"type":"string","description":"Name of Stora documentation","isRequired":true,"uniqueKey":"error.links.items.[INDEX].name","typeLabel":"string"},"url":{"type":"string","format":"uri","description":"URL to Stora documentation","isRequired":true,"uniqueKey":"error.links.items.[INDEX].url","typeLabel":"string\u003curi>"}},"additionalProperties":false,"uniqueKey":"error.links.items.[INDEX]","typeLabel":"object"},"description":"Link(s) to Stora developer resources","isRequired":true,"uniqueKey":"error.links","typeLabel":"object[]"},"message":{"type":"string","description":"Human-readable message providing brief information about the error.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Unique request identifier.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"type":{"type":"string","enum":["invalid_request_error","api_error"],"description":"Type of error returned.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"description":"Error","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"c022b146-d354-412d-9165-0f89b921983d":{"description":"missing stage","content":{"application/json":{"examples":{"invalid_path_id":{"title":"invalid_path_id","summary":"invalid path ID","value":{"error":{"code":"invalid_url_param","details":[{"message":"value `invalid` at `/opportunity_id` does not match pattern: ^opp_","pointer":"/opportunity_id"}],"links":[{"kind":"api_reference","name":"Create a Deal from an Opportunity","url":"https://docs.stora.test/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity"},{"kind":"documentation","name":"Opportunities and deals","url":"https://docs.stora.test/2025-09/guides/opportunities-and-deals"},{"kind":"open_api","name":"OpenAPI specification","url":"https://docs.stora.test/2025-09/openapi.json"},{"kind":"documentation","name":"Errors","url":"https://docs.stora.test/2025-09/guides/errors#invalid_url_param"}],"message":"The request URL param is invalid.","request_id":"01563646-58c1-4607-8fe0-cae3e92c4477","type":"invalid_request_error"}}},"default":{"title":"default","summary":"missing stage","value":{"error":{"code":"invalid_content","details":[{"message":"object at root is missing required properties: stage","pointer":null}],"links":[{"kind":"api_reference","name":"Create a Deal from an Opportunity","url":"https://docs.stora.test/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity"},{"kind":"documentation","name":"Opportunities and deals","url":"https://docs.stora.test/2025-09/guides/opportunities-and-deals"},{"kind":"open_api","name":"OpenAPI specification","url":"https://docs.stora.test/2025-09/openapi.json"},{"kind":"documentation","name":"Errors","url":"https://docs.stora.test/2025-09/guides/errors#invalid_content"}],"message":"The request body content is not valid.","request_id":"01563646-58c1-4607-8fe0-cae3e92c4477","type":"invalid_request_error"}}}},"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"Error","required":["code","details","links","message","request_id","type"],"properties":{"code":{"type":"string","description":"Short code that represents the error.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","description":"ErrorDetail","required":["message","pointer"],"properties":{"message":{"type":"string","description":"Human-readable message providing detailed information about the error.","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"},"pointer":{"oneOf":[{"type":"string","description":"Points to the request field that caused the error:\n- String starting with '/': Exact path of the problematic field.\n- String starting without '/': General hint, cannot pinpoint exact field.\n- null: Error cannot be mapped to any specific field.\n","isRequired":true,"uniqueKey":"error.details.items.[INDEX].pointer.oneOf.0","typeLabel":"string"},{"type":"null","description":"Points to the request field that caused the error:\n- String starting with '/': Exact path of the problematic field.\n- String starting without '/': General hint, cannot pinpoint exact field.\n- null: Error cannot be mapped to any specific field.\n","isRequired":true,"uniqueKey":"error.details.items.[INDEX].pointer.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].pointer","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"description":"Array of error details.","isRequired":true,"uniqueKey":"error.details","typeLabel":"object[]"},"links":{"type":"array","items":{"type":"object","description":"Link to Stora developer resources","required":["kind","name","url"],"properties":{"kind":{"type":"string","description":"Kind of Stora documentation","isRequired":true,"uniqueKey":"error.links.items.[INDEX].kind","typeLabel":"string"},"name":{"type":"string","description":"Name of Stora documentation","isRequired":true,"uniqueKey":"error.links.items.[INDEX].name","typeLabel":"string"},"url":{"type":"string","format":"uri","description":"URL to Stora documentation","isRequired":true,"uniqueKey":"error.links.items.[INDEX].url","typeLabel":"string\u003curi>"}},"additionalProperties":false,"uniqueKey":"error.links.items.[INDEX]","typeLabel":"object"},"description":"Link(s) to Stora developer resources","isRequired":true,"uniqueKey":"error.links","typeLabel":"object[]"},"message":{"type":"string","description":"Human-readable message providing brief information about the error.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Unique request identifier.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"type":{"type":"string","enum":["invalid_request_error","api_error"],"description":"Type of error returned.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"description":"Error","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"fc31f212-a0f8-485d-bda0-93ba35865f8d":{"Bearer":{"description":"Bearer Token necessary to use API","type":"http","scheme":"bearer","bearerFormat":"token","scopes":["public.opportunity:write","public.deal:write"],"schemeName":"Bearer"}},"bfac8194-5b72-4ced-b509-abf3e291166d":{"OAuth2":{"type":"oauth2","description":"OAuth 2 authentication","flows":{"clientCredentials":{"tokenUrl":"https://public-api.stora.co/oauth2/token","scopes":{"public.access_token:read":"Access Token (Read)","public.application:read":"Application (Read)","public.contact:read":"Contact (Read)","public.contact:write":"Contact (Write)","public.contract:read":"Contract (Read)","public.contract_template:read":"Contract Template (Read)","public.coupon:read":"Coupon (Read)","public.credit_note:read":"Credit Note (Read)","public.deal:read":"Deal (Read)","public.deal:write":"Deal (Write)","public.deal_stage:read":"Deal Stage (Read)","public.identity_verification:read":"Identity Verification (Read)","public.invoice:read":"Invoice (Read)","public.note:read":"Note (Read)","public.note:write":"Note (Write)","public.opportunity:read":"Opportunity (Read)","public.opportunity:write":"Opportunity (Write)","public.order:read":"Order (Read)","public.order:write":"Order (Write)","public.price_adjustment:read":"Price Adjustment (Read)","public.price_adjustment:skip_notifications":"Price Adjustment (Skip notifications)","public.price_adjustment:write":"Price Adjustment (Write)","public.product:read":"Product (Read)","public.product:write":"Product (Write)","public.product_category:read":"Product Category (Read)","public.protection_level:read":"Protection Level (Read)","public.protection_level:write":"Protection Level (Write)","public.site:read":"Site (Read)","public.staff:read":"Staff (Read)","public.subscription:read":"Subscription (Read)","public.task:read":"Task (Read)","public.task:write":"Task (Write)","public.tenancy:read":"Tenancy (Read)","public.timeline_event:read":"Timeline Event (Read)","public.timeline_event:write":"Timeline Event (Write)","public.timeline_source:read":"Timeline Source (Read)","public.timeline_template:read":"Timeline Template (Read)","public.unit:read":"Unit (Read)","public.unit:write":"Unit (Write)","public.unit_allocation:read":"Unit Allocation (Read)","public.unit_type:read":"Unit Type (Read)","public.unit_type:write":"Unit Type (Write)","public.webhook_endpoint:read":"Webhook Endpoint (Read)","public.webhook_endpoint:write":"Webhook Endpoint (Write)"}},"authorizationCode":{"authorizationUrl":"https://app.stora.co/oauth2/authorize","tokenUrl":"https://public-api.stora.co/oauth2/token","scopes":{"public.access_token:read":"Access Token (Read)","public.application:read":"Application (Read)","public.contact:read":"Contact (Read)","public.contact:write":"Contact (Write)","public.contract:read":"Contract (Read)","public.contract_template:read":"Contract Template (Read)","public.coupon:read":"Coupon (Read)","public.credit_note:read":"Credit Note (Read)","public.deal:read":"Deal (Read)","public.deal:write":"Deal (Write)","public.deal_stage:read":"Deal Stage (Read)","public.identity_verification:read":"Identity Verification (Read)","public.invoice:read":"Invoice (Read)","public.note:read":"Note (Read)","public.note:write":"Note (Write)","public.opportunity:read":"Opportunity (Read)","public.opportunity:write":"Opportunity (Write)","public.order:read":"Order (Read)","public.order:write":"Order (Write)","public.price_adjustment:read":"Price Adjustment (Read)","public.price_adjustment:skip_notifications":"Price Adjustment (Skip notifications)","public.price_adjustment:write":"Price Adjustment (Write)","public.product:read":"Product (Read)","public.product:write":"Product (Write)","public.product_category:read":"Product Category (Read)","public.protection_level:read":"Protection Level (Read)","public.protection_level:write":"Protection Level (Write)","public.site:read":"Site (Read)","public.staff:read":"Staff (Read)","public.subscription:read":"Subscription (Read)","public.task:read":"Task (Read)","public.task:write":"Task (Write)","public.tenancy:read":"Tenancy (Read)","public.timeline_event:read":"Timeline Event (Read)","public.timeline_event:write":"Timeline Event (Write)","public.timeline_source:read":"Timeline Source (Read)","public.timeline_template:read":"Timeline Template (Read)","public.unit:read":"Unit (Read)","public.unit:write":"Unit (Write)","public.unit_allocation:read":"Unit Allocation (Read)","public.unit_type:read":"Unit Type (Read)","public.unit_type:write":"Unit Type (Write)","public.webhook_endpoint:read":"Webhook Endpoint (Read)","public.webhook_endpoint:write":"Webhook Endpoint (Write)"}}},"scopes":["public.opportunity:write","public.deal:write"],"schemeName":"OAuth2"}}},"servers":{"c00b03b8-e30a-4d5a-a9cb-b56d21be1633":{"url":"https://public-api.stora.co","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"Bearer Token necessary to use API","type":"http","scheme":"bearer","bearerFormat":"token","scopes":["public.opportunity:write","public.deal:write"],"schemeName":"Bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer Token necessary to use API","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"Bearer","name":"Authorization"}],"title":"Bearer"},{"schemes":[{"scheme":{"type":"oauth2","description":"OAuth 2 authentication","flows":{"clientCredentials":{"tokenUrl":"https://public-api.stora.co/oauth2/token","scopes":{"public.access_token:read":"Access Token (Read)","public.application:read":"Application (Read)","public.contact:read":"Contact (Read)","public.contact:write":"Contact (Write)","public.contract:read":"Contract (Read)","public.contract_template:read":"Contract Template (Read)","public.coupon:read":"Coupon (Read)","public.credit_note:read":"Credit Note (Read)","public.deal:read":"Deal (Read)","public.deal:write":"Deal (Write)","public.deal_stage:read":"Deal Stage (Read)","public.identity_verification:read":"Identity Verification (Read)","public.invoice:read":"Invoice (Read)","public.note:read":"Note (Read)","public.note:write":"Note (Write)","public.opportunity:read":"Opportunity (Read)","public.opportunity:write":"Opportunity (Write)","public.order:read":"Order (Read)","public.order:write":"Order (Write)","public.price_adjustment:read":"Price Adjustment (Read)","public.price_adjustment:skip_notifications":"Price Adjustment (Skip notifications)","public.price_adjustment:write":"Price Adjustment (Write)","public.product:read":"Product (Read)","public.product:write":"Product (Write)","public.product_category:read":"Product Category (Read)","public.protection_level:read":"Protection Level (Read)","public.protection_level:write":"Protection Level (Write)","public.site:read":"Site (Read)","public.staff:read":"Staff (Read)","public.subscription:read":"Subscription (Read)","public.task:read":"Task (Read)","public.task:write":"Task (Write)","public.tenancy:read":"Tenancy (Read)","public.timeline_event:read":"Timeline Event (Read)","public.timeline_event:write":"Timeline Event (Write)","public.timeline_source:read":"Timeline Source (Read)","public.timeline_template:read":"Timeline Template (Read)","public.unit:read":"Unit (Read)","public.unit:write":"Unit (Write)","public.unit_allocation:read":"Unit Allocation (Read)","public.unit_type:read":"Unit Type (Read)","public.unit_type:write":"Unit Type (Write)","public.webhook_endpoint:read":"Webhook Endpoint (Read)","public.webhook_endpoint:write":"Webhook Endpoint (Write)"}},"authorizationCode":{"authorizationUrl":"https://app.stora.co/oauth2/authorize","tokenUrl":"https://public-api.stora.co/oauth2/token","scopes":{"public.access_token:read":"Access Token (Read)","public.application:read":"Application (Read)","public.contact:read":"Contact (Read)","public.contact:write":"Contact (Write)","public.contract:read":"Contract (Read)","public.contract_template:read":"Contract Template (Read)","public.coupon:read":"Coupon (Read)","public.credit_note:read":"Credit Note (Read)","public.deal:read":"Deal (Read)","public.deal:write":"Deal (Write)","public.deal_stage:read":"Deal Stage (Read)","public.identity_verification:read":"Identity Verification (Read)","public.invoice:read":"Invoice (Read)","public.note:read":"Note (Read)","public.note:write":"Note (Write)","public.opportunity:read":"Opportunity (Read)","public.opportunity:write":"Opportunity (Write)","public.order:read":"Order (Read)","public.order:write":"Order (Write)","public.price_adjustment:read":"Price Adjustment (Read)","public.price_adjustment:skip_notifications":"Price Adjustment (Skip notifications)","public.price_adjustment:write":"Price Adjustment (Write)","public.product:read":"Product (Read)","public.product:write":"Product (Write)","public.product_category:read":"Product Category (Read)","public.protection_level:read":"Protection Level (Read)","public.protection_level:write":"Protection Level (Write)","public.site:read":"Site (Read)","public.staff:read":"Staff (Read)","public.subscription:read":"Subscription (Read)","public.task:read":"Task (Read)","public.task:write":"Task (Write)","public.tenancy:read":"Tenancy (Read)","public.timeline_event:read":"Timeline Event (Read)","public.timeline_event:write":"Timeline Event (Write)","public.timeline_source:read":"Timeline Source (Read)","public.timeline_template:read":"Timeline Template (Read)","public.unit:read":"Unit (Read)","public.unit:write":"Unit (Write)","public.unit_allocation:read":"Unit Allocation (Read)","public.unit_type:read":"Unit Type (Read)","public.unit_type:write":"Unit Type (Write)","public.webhook_endpoint:read":"Webhook Endpoint (Read)","public.webhook_endpoint:write":"Webhook Endpoint (Write)"}}},"scopes":["public.opportunity:write","public.deal:write"],"schemeName":"OAuth2"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"OAuth 2 authentication","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"OAuth2","name":"Authorization"}],"title":"OAuth2"}]},"originalFileLocation":"2025-09/openapi.json"},"subdomain":"stora-f4154d0c","siteName":"Stora","title":"Create a Deal from an Opportunity - Stora","navMaps":{"firstHrefInVersion":{"2025-09":{"href":"/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-11-20T14:32:25.444Z","originalFileLocation":"2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity.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=\"Create a deal from a qualified opportunity and associate the two. Use Associate an Opportunity with a Deal instead when the deal already exists, or Create a Deal for a deal without an opportunity. The deal copies the opportunity\u0026#x27;s contact, site and line items, and starts at the given stage. Its name is \u0026quot; Deal\u0026quot; unless you send name. An archived opportunity is unarchived. deal.created and opportunity.associated webhooks fire, and an assignee is notified by email. Send an Idempotency-Key header so a retry doesn\u0026#x27;t create a second deal. See Capture and qualify leads. Required authorization scopes: public.opportunity:write, public.deal:write\">\u003cmeta data-mint-head name=\"application-name\" content=\"Stora\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/stora-f4154d0c/vqyFqxlOxTWjpk26/_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/stora-f4154d0c/vqyFqxlOxTWjpk26/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/stora-f4154d0c/vqyFqxlOxTWjpk26/_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/stora-f4154d0c/vqyFqxlOxTWjpk26/_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/stora-f4154d0c/vqyFqxlOxTWjpk26/_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/stora-f4154d0c/vqyFqxlOxTWjpk26/_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/stora-f4154d0c/vqyFqxlOxTWjpk26/_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/stora-f4154d0c/vqyFqxlOxTWjpk26/_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/stora-f4154d0c/vqyFqxlOxTWjpk26/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a Deal from an Opportunity - Stora\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a deal from a qualified opportunity and associate the two. Use Associate an Opportunity with a Deal instead when the deal already exists, or Create a Deal for a deal without an opportunity. The deal copies the opportunity\u0026#x27;s contact, site and line items, and starts at the given stage. Its name is \u0026quot; Deal\u0026quot; unless you send name. An archived opportunity is unarchived. deal.created and opportunity.associated webhooks fire, and an assignee is notified by email. Send an Idempotency-Key header so a retry doesn\u0026#x27;t create a second deal. See Capture and qualify leads. Required authorization scopes: public.opportunity:write, public.deal:write\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Stora\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.stora.co/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://stora-f4154d0c.mintlify.site/_mintlify/api/og/v2?division=Opportunities\u0026amp;title=Create+a+Deal+from+an+Opportunity\u0026amp;description=Create+a+deal+from+a+qualified+opportunity+and+associate+the+two.+Use+**Associate+an+Opportunity+with+a+Deal**+instead+when+the+deal+already+exists%2C+or+**Create\u0026amp;theme=6db5bd5e68127dc65254e888\u0026amp;signature=72be8791da06b3da6cf82e01298cd0a4e96a6b42306147f5d00b9e56e4be3a77\">\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=\"Create a Deal from an Opportunity - Stora\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a deal from a qualified opportunity and associate the two. Use Associate an Opportunity with a Deal instead when the deal already exists, or Create a Deal for a deal without an opportunity. The deal copies the opportunity\u0026#x27;s contact, site and line items, and starts at the given stage. Its name is \u0026quot; Deal\u0026quot; unless you send name. An archived opportunity is unarchived. deal.created and opportunity.associated webhooks fire, and an assignee is notified by email. Send an Idempotency-Key header so a retry doesn\u0026#x27;t create a second deal. See Capture and qualify leads. Required authorization scopes: public.opportunity:write, public.deal:write\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://stora-f4154d0c.mintlify.site/_mintlify/api/og/v2?division=Opportunities\u0026amp;title=Create+a+Deal+from+an+Opportunity\u0026amp;description=Create+a+deal+from+a+qualified+opportunity+and+associate+the+two.+Use+**Associate+an+Opportunity+with+a+Deal**+instead+when+the+deal+already+exists%2C+or+**Create\u0026amp;theme=6db5bd5e68127dc65254e888\u0026amp;signature=72be8791da06b3da6cf82e01298cd0a4e96a6b42306147f5d00b9e56e4be3a77\">\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/stora-f4154d0c/vqyFqxlOxTWjpk26/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Stora\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#05195A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.stora.co/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.stora.co/#organization\",\"name\":\"Stora\",\"url\":\"https://docs.stora.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/stora-f4154d0c/OkDRMCLydnzT1IFG/logo/stora-logo.svg?fit=max\u0026auto=format\u0026n=OkDRMCLydnzT1IFG\u0026q=85\u0026s=208e8987df1797b88ccc8c1c418f8126\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.stora.co#website\",\"name\":\"Stora\",\"url\":\"https://docs.stora.co\",\"publisher\":{\"@id\":\"https://docs.stora.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.stora.co/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity#webpage\",\"url\":\"https://docs.stora.co/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity\",\"name\":\"Create a Deal from an Opportunity\",\"description\":\"Create a deal from a qualified opportunity and associate the two. Use Associate an Opportunity with a Deal instead when the deal already exists, or Create a Deal for a deal without an opportunity. The deal copies the opportunity's contact, site and line items, and starts at the given stage. Its name is \\\" Deal\\\" unless you send name. An archived opportunity is unarchived. deal.created and opportunity.associated webhooks fire, and an assignee is notified by email. Send an Idempotency-Key header so a retry doesn't create a second deal. See Capture and qualify leads. Required authorization scopes: public.opportunity:write, public.deal:write\",\"dateModified\":\"2026-11-20T14:32:25.444Z\",\"isPartOf\":{\"@id\":\"https://docs.stora.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.stora.co/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.stora.co/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Opportunities\",\"item\":\"https://docs.stora.co/2025-09/api-reference/opportunities/archive-an-opportunity\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a Deal from an Opportunity\",\"item\":\"https://docs.stora.co/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.stora.co/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity#apireference\",\"headline\":\"Create a Deal from an Opportunity\",\"name\":\"Create a Deal from an Opportunity\",\"description\":\"Create a deal from a qualified opportunity and associate the two. Use Associate an Opportunity with a Deal instead when the deal already exists, or Create a Deal for a deal without an opportunity. The deal copies the opportunity's contact, site and line items, and starts at the given stage. Its name is \\\" Deal\\\" unless you send name. An archived opportunity is unarchived. deal.created and opportunity.associated webhooks fire, and an assignee is notified by email. Send an Idempotency-Key header so a retry doesn't create a second deal. See Capture and qualify leads. Required authorization scopes: public.opportunity:write, public.deal:write\",\"url\":\"https://docs.stora.co/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity\",\"mainEntityOfPage\":{\"@id\":\"https://docs.stora.co/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity#webpage\"},\"dateModified\":\"2026-11-20T14:32:25.444Z\",\"publisher\":{\"@id\":\"https://docs.stora.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.stora.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Stora\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Stora\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity.md","siteName":"Stora","nav":{"global":null,"versions":[{"version":"2025-09","default":true,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/2025-09/guides/introduction"}]},{"tab":"API reference","groups":[{"group":"Contacts","pages":[{"title":"List all Contacts","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/contacts","href":"/2025-09/api-reference/contacts/list-all-contacts"},{"title":"Create a Contact","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json post /2025-09/contacts","href":"/2025-09/api-reference/contacts/create-a-contact"},{"title":"Show a Contact","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/contacts/{contact_id}","href":"/2025-09/api-reference/contacts/show-a-contact"},{"title":"Delete a Contact","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json delete /2025-09/contacts/{contact_id}","href":"/2025-09/api-reference/contacts/delete-a-contact"},{"title":"Update a Contact","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json patch /2025-09/contacts/{contact_id}","href":"/2025-09/api-reference/contacts/update-a-contact"}]},{"group":"Contract Templates","pages":[{"title":"List all Contract Templates","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/contract_templates","href":"/2025-09/api-reference/contract-templates/list-all-contract-templates"},{"title":"Show a Contract Template","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/contract_templates/{contract_template_id}","href":"/2025-09/api-reference/contract-templates/show-a-contract-template"}]},{"group":"Contracts","pages":[{"title":"List all Contracts","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json get /2025-09/contracts","href":"/2025-09/api-reference/contracts/list-all-contracts"},{"title":"Show a Contract","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json get /2025-09/contracts/{contract_id}","href":"/2025-09/api-reference/contracts/show-a-contract"}]},{"group":"Coupons","pages":[{"title":"List all Coupons","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/coupons","href":"/2025-09/api-reference/coupons/list-all-coupons"},{"title":"Show a Coupon","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/coupons/{coupon_id}","href":"/2025-09/api-reference/coupons/show-a-coupon"}]},{"group":"Credit Notes","pages":[{"title":"List all Credit Notes","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/credit_notes","href":"/2025-09/api-reference/credit-notes/list-all-credit-notes"},{"title":"Show a Credit Note","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/credit_notes/{credit_note_id}","href":"/2025-09/api-reference/credit-notes/show-a-credit-note"}]},{"group":"Deals","pages":[{"title":"Lose a Deal","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json post /2025-09/deals/{deal_id}/lose","href":"/2025-09/api-reference/deals/lose-a-deal"},{"title":"Reopen a Deal","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json post /2025-09/deals/{deal_id}/reopen","href":"/2025-09/api-reference/deals/reopen-a-deal"},{"title":"Win a Deal","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json post /2025-09/deals/{deal_id}/win","href":"/2025-09/api-reference/deals/win-a-deal"},{"title":"List all Deals","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json get /2025-09/deals","href":"/2025-09/api-reference/deals/list-all-deals"},{"title":"Create a Deal","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json post /2025-09/deals","href":"/2025-09/api-reference/deals/create-a-deal"},{"title":"Show a Deal","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json get /2025-09/deals/{deal_id}","href":"/2025-09/api-reference/deals/show-a-deal"},{"title":"Delete a Deal","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json delete /2025-09/deals/{deal_id}","href":"/2025-09/api-reference/deals/delete-a-deal"},{"title":"Update a Deal","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json patch /2025-09/deals/{deal_id}","href":"/2025-09/api-reference/deals/update-a-deal"}]},{"group":"Deals / Stages","pages":[{"title":"List all Stages","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json get /2025-09/deals/stages","href":"/2025-09/api-reference/deals-stages/list-all-stages"},{"title":"Show a Deal Stage","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json get /2025-09/deals/stages/{stage_id}","href":"/2025-09/api-reference/deals-stages/show-a-deal-stage"}]},{"group":"Identity Verifications","pages":[{"title":"List all Identity Verifications","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json get /2025-09/identity_verifications","href":"/2025-09/api-reference/identity-verifications/list-all-identity-verifications"},{"title":"Show an Identity Verification","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json get /2025-09/identity_verifications/{identity_verification_id}","href":"/2025-09/api-reference/identity-verifications/show-an-identity-verification"}]},{"group":"Images","pages":[{"title":"Get an image","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json get /2025-09/images/{token}/{filename}","href":"/2025-09/api-reference/images/get-an-image"}]},{"group":"Invoices","pages":[{"title":"List all Invoices","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/invoices","href":"/2025-09/api-reference/invoices/list-all-invoices"},{"title":"Show an Invoice","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/invoices/{invoice_id}","href":"/2025-09/api-reference/invoices/show-an-invoice"}]},{"group":"Notes","pages":[{"title":"List all Notes","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json get /2025-09/notes","href":"/2025-09/api-reference/notes/list-all-notes"},{"title":"Create a Note","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json post /2025-09/notes","href":"/2025-09/api-reference/notes/create-a-note"},{"title":"Show a Note","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json get /2025-09/notes/{note_id}","href":"/2025-09/api-reference/notes/show-a-note"},{"title":"Delete a Note","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json delete /2025-09/notes/{note_id}","href":"/2025-09/api-reference/notes/delete-a-note"},{"title":"Update a Note","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json patch /2025-09/notes/{note_id}","href":"/2025-09/api-reference/notes/update-a-note"}]},{"group":"OAuth 2","pages":[{"title":"Retrieve an Access Token","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json post /oauth2/token","href":"/2025-09/api-reference/oauth-2/retrieve-an-access-token"},{"title":"Retrieve info for the Access Token","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /oauth2/token/info","href":"/2025-09/api-reference/oauth-2/retrieve-info-for-the-access-token"},{"title":"Introspect an Access Token","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json post /oauth2/introspect","href":"/2025-09/api-reference/oauth-2/introspect-an-access-token"},{"title":"Revoke an Access Token","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json post /oauth2/revoke","href":"/2025-09/api-reference/oauth-2/revoke-an-access-token"}]},{"group":"Opportunities","pages":[{"title":"Archive an Opportunity","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json post /2025-09/opportunities/{opportunity_id}/archive","href":"/2025-09/api-reference/opportunities/archive-an-opportunity"},{"title":"Associate an Opportunity with a Deal","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json post /2025-09/opportunities/{opportunity_id}/associate_deal","href":"/2025-09/api-reference/opportunities/associate-an-opportunity-with-a-deal"},{"title":"Disassociate an Opportunity from its Deal","description":"Remove the association between an opportunity and its deal, so you can associate it with another deal or create a new deal from it. The opportunity returns to `open`, or to `archived` if it was archived while associated. The deal isn't changed.\n\nSee [Capture and qualify leads](https://docs.stora.co/2025-09/guides/opportunities-and-deals).\n\nRequired authorization scopes: `public.opportunity:write`, `public.deal:write`\n","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json delete /2025-09/opportunities/{opportunity_id}/associate_deal","href":"/2025-09/api-reference/opportunities/disassociate-an-opportunity-from-its-deal"},{"title":"Create a Deal from an Opportunity","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json post /2025-09/opportunities/{opportunity_id}/deal","href":"/2025-09/api-reference/opportunities/create-a-deal-from-an-opportunity"},{"title":"Unarchive an Opportunity","description":"Return an archived opportunity to `open` when the lead's interest resumes.\n\nOnly an `archived` opportunity can be unarchived. An open opportunity, or one associated with a deal, returns `409 Conflict`. An `opportunity.unarchived` webhook fires.\n\nRequired authorization scope: `public.opportunity:write`\n","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json post /2025-09/opportunities/{opportunity_id}/unarchive","href":"/2025-09/api-reference/opportunities/unarchive-an-opportunity"},{"title":"List all Opportunities","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json get /2025-09/opportunities","href":"/2025-09/api-reference/opportunities/list-all-opportunities"},{"title":"Create an Opportunity","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json post /2025-09/opportunities","href":"/2025-09/api-reference/opportunities/create-an-opportunity"},{"title":"Show an Opportunity","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json get /2025-09/opportunities/{opportunity_id}","href":"/2025-09/api-reference/opportunities/show-an-opportunity"},{"title":"Delete an Opportunity","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json delete /2025-09/opportunities/{opportunity_id}","href":"/2025-09/api-reference/opportunities/delete-an-opportunity"},{"title":"Update an Opportunity","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json patch /2025-09/opportunities/{opportunity_id}","href":"/2025-09/api-reference/opportunities/update-an-opportunity"}]},{"group":"Orders","pages":[{"title":"Abandon an Order","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json post /2025-09/orders/{order_id}/abandon","href":"/2025-09/api-reference/orders/abandon-an-order"},{"title":"Finalize an Order","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json post /2025-09/orders/{order_id}/finalize","href":"/2025-09/api-reference/orders/finalize-an-order"},{"title":"Validate an Order","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/orders/{order_id}/validate","href":"/2025-09/api-reference/orders/validate-an-order"},{"title":"List all Orders","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/orders","href":"/2025-09/api-reference/orders/list-all-orders"},{"title":"Create an Order","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json post /2025-09/orders","href":"/2025-09/api-reference/orders/create-an-order"},{"title":"Show an Order","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/orders/{order_id}","href":"/2025-09/api-reference/orders/show-an-order"},{"title":"Delete an Order","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json delete /2025-09/orders/{order_id}","href":"/2025-09/api-reference/orders/delete-an-order"},{"title":"Update an Order","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json patch /2025-09/orders/{order_id}","href":"/2025-09/api-reference/orders/update-an-order"}]},{"group":"Orders / Line Items","pages":[{"title":"List all Line Items","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/orders/{order_id}/line_items","href":"/2025-09/api-reference/orders-line-items/list-all-line-items"},{"title":"Create a Line Item","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json post /2025-09/orders/{order_id}/line_items","href":"/2025-09/api-reference/orders-line-items/create-a-line-item"},{"title":"Delete a Line Item","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json delete /2025-09/orders/{order_id}/line_items/{line_item_id}","href":"/2025-09/api-reference/orders-line-items/delete-a-line-item"},{"title":"Update a Line Item","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json patch /2025-09/orders/{order_id}/line_items/{line_item_id}","href":"/2025-09/api-reference/orders-line-items/update-a-line-item"}]},{"group":"Price Adjustments","pages":[{"title":"Schedule a Price Adjustment","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json post /2025-09/price_adjustments/{price_adjustment_id}/schedule","href":"/2025-09/api-reference/price-adjustments/schedule-a-price-adjustment"},{"title":"List all Price Adjustments","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json get /2025-09/price_adjustments","href":"/2025-09/api-reference/price-adjustments/list-all-price-adjustments"},{"title":"Create a Price Adjustment","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json post /2025-09/price_adjustments","href":"/2025-09/api-reference/price-adjustments/create-a-price-adjustment"},{"title":"Show a Price Adjustment","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json get /2025-09/price_adjustments/{price_adjustment_id}","href":"/2025-09/api-reference/price-adjustments/show-a-price-adjustment"},{"title":"Delete a Price Adjustment","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json delete /2025-09/price_adjustments/{price_adjustment_id}","href":"/2025-09/api-reference/price-adjustments/delete-a-price-adjustment"},{"title":"Update a Price Adjustment","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json patch /2025-09/price_adjustments/{price_adjustment_id}","href":"/2025-09/api-reference/price-adjustments/update-a-price-adjustment"}]},{"group":"Product Categories","pages":[{"title":"List all Product Categories","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/product_categories","href":"/2025-09/api-reference/product-categories/list-all-product-categories"},{"title":"Show a Product Category","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/product_categories/{product_category_id}","href":"/2025-09/api-reference/product-categories/show-a-product-category"}]},{"group":"Products","pages":[{"title":"Create Base Price for the Product","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json post /2025-09/products/{product_id}/base_price","href":"/2025-09/api-reference/products/create-base-price-for-the-product"},{"title":"List all Products","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/products","href":"/2025-09/api-reference/products/list-all-products"},{"title":"Show a Product","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/products/{product_id}","href":"/2025-09/api-reference/products/show-a-product"}]},{"group":"Protection Levels","pages":[{"title":"Create Base Price for the Protection Level","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json post /2025-09/protection_levels/{protection_level_id}/base_price","href":"/2025-09/api-reference/protection-levels/create-base-price-for-the-protection-level"},{"title":"List all Protection Levels","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/protection_levels","href":"/2025-09/api-reference/protection-levels/list-all-protection-levels"},{"title":"Show a Protection Level","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/protection_levels/{protection_level_id}","href":"/2025-09/api-reference/protection-levels/show-a-protection-level"}]},{"group":"Sites","pages":[{"title":"List all Sites","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/sites","href":"/2025-09/api-reference/sites/list-all-sites"},{"title":"Show a Site","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/sites/{site_id}","href":"/2025-09/api-reference/sites/show-a-site"}]},{"group":"Staff","pages":[{"title":"List all Staff","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/staff","href":"/2025-09/api-reference/staff/list-all-staff"},{"title":"Show a Staff Member","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/staff/{staff_id}","href":"/2025-09/api-reference/staff/show-a-staff-member"}]},{"group":"Subscriptions","pages":[{"title":"List all Subscriptions","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/subscriptions","href":"/2025-09/api-reference/subscriptions/list-all-subscriptions"},{"title":"Show a Subscription","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/subscriptions/{subscription_id}","href":"/2025-09/api-reference/subscriptions/show-a-subscription"}]},{"group":"Tasks","pages":[{"title":"Complete a Task","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json post /2025-09/tasks/{task_id}/complete","href":"/2025-09/api-reference/tasks/complete-a-task"},{"title":"Open a Task","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json post /2025-09/tasks/{task_id}/open","href":"/2025-09/api-reference/tasks/open-a-task"},{"title":"List all Tasks","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json get /2025-09/tasks","href":"/2025-09/api-reference/tasks/list-all-tasks"},{"title":"Create a Task","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json post /2025-09/tasks","href":"/2025-09/api-reference/tasks/create-a-task"},{"title":"Show a Task","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json get /2025-09/tasks/{task_id}","href":"/2025-09/api-reference/tasks/show-a-task"},{"title":"Delete a Task","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json delete /2025-09/tasks/{task_id}","href":"/2025-09/api-reference/tasks/delete-a-task"},{"title":"Update a Task","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json patch /2025-09/tasks/{task_id}","href":"/2025-09/api-reference/tasks/update-a-task"}]},{"group":"Tenancies","pages":[{"title":"List all Tenancies","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/tenancies","href":"/2025-09/api-reference/tenancies/list-all-tenancies"},{"title":"Show a Tenancy","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/tenancies/{tenancy_id}","href":"/2025-09/api-reference/tenancies/show-a-tenancy"}]},{"group":"Timeline / Events","pages":[{"title":"Create an Event","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json post /2025-09/timeline/events","href":"/2025-09/api-reference/timeline-events/create-an-event"},{"title":"Delete an Event","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json delete /2025-09/timeline/events/{event_id}","href":"/2025-09/api-reference/timeline-events/delete-an-event"},{"title":"Update an Event","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json patch /2025-09/timeline/events/{event_id}","href":"/2025-09/api-reference/timeline-events/update-an-event"}]},{"group":"Timeline / Sources","pages":[{"title":"List all Sources","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json get /2025-09/timeline/sources","href":"/2025-09/api-reference/timeline-sources/list-all-sources"},{"title":"Show a Source","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json get /2025-09/timeline/sources/{source_id}","href":"/2025-09/api-reference/timeline-sources/show-a-source"}]},{"group":"Timeline / Templates","pages":[{"title":"List all Templates","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json get /2025-09/timeline/templates","href":"/2025-09/api-reference/timeline-templates/list-all-templates"},{"title":"Show a Template","deprecated":null,"version":null,"tag":"Beta","openapi":"/2025-09/openapi.json get /2025-09/timeline/templates/{template_id}","href":"/2025-09/api-reference/timeline-templates/show-a-template"}]},{"group":"Unit Allocations","pages":[{"title":"List all Unit Allocations","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/unit_allocations","href":"/2025-09/api-reference/unit-allocations/list-all-unit-allocations"},{"title":"Show a Unit Allocation","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/unit_allocations/{unit_allocation_id}","href":"/2025-09/api-reference/unit-allocations/show-a-unit-allocation"}]},{"group":"Unit Types","pages":[{"title":"Create Base Price for the Unit Type","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json post /2025-09/unit_types/{unit_type_id}/base_price","href":"/2025-09/api-reference/unit-types/create-base-price-for-the-unit-type"},{"title":"List all Unit Types","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/unit_types","href":"/2025-09/api-reference/unit-types/list-all-unit-types"},{"title":"Show a Unit Type","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/unit_types/{unit_type_id}","href":"/2025-09/api-reference/unit-types/show-a-unit-type"}]},{"group":"Units","pages":[{"title":"Deallocate a Unit","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json post /2025-09/units/{unit_id}/deallocate","href":"/2025-09/api-reference/units/deallocate-a-unit"},{"title":"Grant Access to a Unit","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json post /2025-09/units/{unit_id}/grant_access","href":"/2025-09/api-reference/units/grant-access-to-a-unit"},{"title":"Overlock Units by Contact","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json post /2025-09/units/overlock","href":"/2025-09/api-reference/units/overlock-units-by-contact"},{"title":"Remove Overlock from Units by Contact","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json post /2025-09/units/remove_overlock","href":"/2025-09/api-reference/units/remove-overlock-from-units-by-contact"},{"title":"Reserve a Unit","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json post /2025-09/units/{unit_id}/reserve","href":"/2025-09/api-reference/units/reserve-a-unit"},{"title":"List all Units","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/units","href":"/2025-09/api-reference/units/list-all-units"},{"title":"Show a Unit","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/units/{unit_id}","href":"/2025-09/api-reference/units/show-a-unit"}]},{"group":"Webhook Endpoints","pages":[{"title":"Disable a Webhook Endpoint","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json post /2025-09/webhook_endpoints/{webhook_endpoint_id}/disable","href":"/2025-09/api-reference/webhook-endpoints/disable-a-webhook-endpoint"},{"title":"Enable a Webhook Endpoint","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json post /2025-09/webhook_endpoints/{webhook_endpoint_id}/enable","href":"/2025-09/api-reference/webhook-endpoints/enable-a-webhook-endpoint"},{"title":"List all Webhook Endpoints","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/webhook_endpoints","href":"/2025-09/api-reference/webhook-endpoints/list-all-webhook-endpoints"},{"title":"Create a Webhook Endpoint","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json post /2025-09/webhook_endpoints","href":"/2025-09/api-reference/webhook-endpoints/create-a-webhook-endpoint"},{"title":"Show a Webhook Endpoint","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json get /2025-09/webhook_endpoints/{webhook_endpoint_id}","href":"/2025-09/api-reference/webhook-endpoints/show-a-webhook-endpoint"},{"title":"Delete a Webhook Endpoint","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json delete /2025-09/webhook_endpoints/{webhook_endpoint_id}","href":"/2025-09/api-reference/webhook-endpoints/delete-a-webhook-endpoint"},{"title":"Update a Webhook Endpoint","deprecated":null,"version":null,"openapi":"/2025-09/openapi.json patch /2025-09/webhook_endpoints/{webhook_endpoint_id}","href":"/2025-09/api-reference/webhook-endpoints/update-a-webhook-endpoint"}]},{"group":"Webhooks","pages":[{"title":"contact.churned","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook contact.churned","href":"/2025-09/api-reference/webhooks/contactchurned"},{"title":"contact.converted","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook contact.converted","href":"/2025-09/api-reference/webhooks/contactconverted"},{"title":"contact.created","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook contact.created","href":"/2025-09/api-reference/webhooks/contactcreated"},{"title":"contact.updated","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook contact.updated","href":"/2025-09/api-reference/webhooks/contactupdated"},{"title":"contract.created","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook contract.created","href":"/2025-09/api-reference/webhooks/contractcreated"},{"title":"contract.signed","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook contract.signed","href":"/2025-09/api-reference/webhooks/contractsigned"},{"title":"coupon.created","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook coupon.created","href":"/2025-09/api-reference/webhooks/couponcreated"},{"title":"coupon.updated","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook coupon.updated","href":"/2025-09/api-reference/webhooks/couponupdated"},{"title":"credit_note.created","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook credit_note.created","href":"/2025-09/api-reference/webhooks/credit_notecreated"},{"title":"credit_note.updated","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook credit_note.updated","href":"/2025-09/api-reference/webhooks/credit_noteupdated"},{"title":"deal.created","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook deal.created","href":"/2025-09/api-reference/webhooks/dealcreated"},{"title":"deal.lost","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook deal.lost","href":"/2025-09/api-reference/webhooks/deallost"},{"title":"deal.reopened","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook deal.reopened","href":"/2025-09/api-reference/webhooks/dealreopened"},{"title":"deal.stage_changed","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook deal.stage_changed","href":"/2025-09/api-reference/webhooks/dealstage_changed"},{"title":"deal.updated","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook deal.updated","href":"/2025-09/api-reference/webhooks/dealupdated"},{"title":"deal.won","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook deal.won","href":"/2025-09/api-reference/webhooks/dealwon"},{"title":"identity_verification.cancelled","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook identity_verification.cancelled","href":"/2025-09/api-reference/webhooks/identity_verificationcancelled"},{"title":"identity_verification.failed","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook identity_verification.failed","href":"/2025-09/api-reference/webhooks/identity_verificationfailed"},{"title":"identity_verification.processing","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook identity_verification.processing","href":"/2025-09/api-reference/webhooks/identity_verificationprocessing"},{"title":"identity_verification.succeeded","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook identity_verification.succeeded","href":"/2025-09/api-reference/webhooks/identity_verificationsucceeded"},{"title":"invoice.created","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook invoice.created","href":"/2025-09/api-reference/webhooks/invoicecreated"},{"title":"invoice.finalized","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook invoice.finalized","href":"/2025-09/api-reference/webhooks/invoicefinalized"},{"title":"invoice.marked_uncollectible","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook invoice.marked_uncollectible","href":"/2025-09/api-reference/webhooks/invoicemarked_uncollectible"},{"title":"invoice.overdue","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook invoice.overdue","href":"/2025-09/api-reference/webhooks/invoiceoverdue"},{"title":"invoice.paid","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook invoice.paid","href":"/2025-09/api-reference/webhooks/invoicepaid"},{"title":"invoice.payment_failed","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook invoice.payment_failed","href":"/2025-09/api-reference/webhooks/invoicepayment_failed"},{"title":"invoice.updated","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook invoice.updated","href":"/2025-09/api-reference/webhooks/invoiceupdated"},{"title":"note.created","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook note.created","href":"/2025-09/api-reference/webhooks/notecreated"},{"title":"note.updated","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook note.updated","href":"/2025-09/api-reference/webhooks/noteupdated"},{"title":"opportunity.archived","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook opportunity.archived","href":"/2025-09/api-reference/webhooks/opportunityarchived"},{"title":"opportunity.associated","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook opportunity.associated","href":"/2025-09/api-reference/webhooks/opportunityassociated"},{"title":"opportunity.created","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook opportunity.created","href":"/2025-09/api-reference/webhooks/opportunitycreated"},{"title":"opportunity.deleted","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook opportunity.deleted","href":"/2025-09/api-reference/webhooks/opportunitydeleted"},{"title":"opportunity.unarchived","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook opportunity.unarchived","href":"/2025-09/api-reference/webhooks/opportunityunarchived"},{"title":"opportunity.updated","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook opportunity.updated","href":"/2025-09/api-reference/webhooks/opportunityupdated"},{"title":"order.abandoned","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook order.abandoned","href":"/2025-09/api-reference/webhooks/orderabandoned"},{"title":"order.completed","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook order.completed","href":"/2025-09/api-reference/webhooks/ordercompleted"},{"title":"order.created","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook order.created","href":"/2025-09/api-reference/webhooks/ordercreated"},{"title":"order.finalized","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook order.finalized","href":"/2025-09/api-reference/webhooks/orderfinalized"},{"title":"price_adjustment.cancelled","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook price_adjustment.cancelled","href":"/2025-09/api-reference/webhooks/price_adjustmentcancelled"},{"title":"price_adjustment.created","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook price_adjustment.created","href":"/2025-09/api-reference/webhooks/price_adjustmentcreated"},{"title":"price_adjustment.failed","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook price_adjustment.failed","href":"/2025-09/api-reference/webhooks/price_adjustmentfailed"},{"title":"price_adjustment.invoiced","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook price_adjustment.invoiced","href":"/2025-09/api-reference/webhooks/price_adjustmentinvoiced"},{"title":"price_adjustment.rescheduled","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook price_adjustment.rescheduled","href":"/2025-09/api-reference/webhooks/price_adjustmentrescheduled"},{"title":"price_adjustment.scheduled","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook price_adjustment.scheduled","href":"/2025-09/api-reference/webhooks/price_adjustmentscheduled"},{"title":"price_adjustment.updated","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook price_adjustment.updated","href":"/2025-09/api-reference/webhooks/price_adjustmentupdated"},{"title":"protection_level.created","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook protection_level.created","href":"/2025-09/api-reference/webhooks/protection_levelcreated"},{"title":"protection_level.updated","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook protection_level.updated","href":"/2025-09/api-reference/webhooks/protection_levelupdated"},{"title":"subscription.cancelled","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook subscription.cancelled","href":"/2025-09/api-reference/webhooks/subscriptioncancelled"},{"title":"subscription.created","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook subscription.created","href":"/2025-09/api-reference/webhooks/subscriptioncreated"},{"title":"subscription.ended","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook subscription.ended","href":"/2025-09/api-reference/webhooks/subscriptionended"},{"title":"subscription.resumed","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook subscription.resumed","href":"/2025-09/api-reference/webhooks/subscriptionresumed"},{"title":"subscription.started","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook subscription.started","href":"/2025-09/api-reference/webhooks/subscriptionstarted"},{"title":"task.completed","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook task.completed","href":"/2025-09/api-reference/webhooks/taskcompleted"},{"title":"task.created","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook task.created","href":"/2025-09/api-reference/webhooks/taskcreated"},{"title":"task.reopened","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook task.reopened","href":"/2025-09/api-reference/webhooks/taskreopened"},{"title":"task.updated","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook task.updated","href":"/2025-09/api-reference/webhooks/taskupdated"},{"title":"tenancy.auto_reservation.failed","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook tenancy.auto_reservation.failed","href":"/2025-09/api-reference/webhooks/tenancyauto_reservationfailed"},{"title":"tenancy.auto_reservation.partially_succeeded","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook tenancy.auto_reservation.partially_succeeded","href":"/2025-09/api-reference/webhooks/tenancyauto_reservationpartially_succeeded"},{"title":"tenancy.auto_reservation.succeeded","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook tenancy.auto_reservation.succeeded","href":"/2025-09/api-reference/webhooks/tenancyauto_reservationsucceeded"},{"title":"tenancy.created","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook tenancy.created","href":"/2025-09/api-reference/webhooks/tenancycreated"},{"title":"tenancy.started","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook tenancy.started","href":"/2025-09/api-reference/webhooks/tenancystarted"},{"title":"unit_type.created","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook unit_type.created","href":"/2025-09/api-reference/webhooks/unit_typecreated"},{"title":"unit_type.updated","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook unit_type.updated","href":"/2025-09/api-reference/webhooks/unit_typeupdated"},{"title":"unit.available","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook unit.available","href":"/2025-09/api-reference/webhooks/unitavailable"},{"title":"unit.created","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook unit.created","href":"/2025-09/api-reference/webhooks/unitcreated"},{"title":"unit.deallocated","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook unit.deallocated","href":"/2025-09/api-reference/webhooks/unitdeallocated"},{"title":"unit.occupied","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook unit.occupied","href":"/2025-09/api-reference/webhooks/unitoccupied"},{"title":"unit.overlocked","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook unit.overlocked","href":"/2025-09/api-reference/webhooks/unitoverlocked"},{"title":"unit.repossessed","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook unit.repossessed","href":"/2025-09/api-reference/webhooks/unitrepossessed"},{"title":"unit.reserved","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook unit.reserved","href":"/2025-09/api-reference/webhooks/unitreserved"},{"title":"unit.unavailable","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook unit.unavailable","href":"/2025-09/api-reference/webhooks/unitunavailable"},{"title":"unit.updated","version":null,"deprecated":null,"openapi":"/2025-09/openapi.json webhook unit.updated","href":"/2025-09/api-reference/webhooks/unitupdated"}]}]}]}]},"basePath":"","title":"Create a Deal from an Opportunity - Stora","deploymentId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","buildId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BtG4DSkw.js","snippetPresets-C1k1xDhp.js","utils-PMJoEt4Y.js","style-to-object-BY3JEAdk.js","utils-DW3Pr7Jq.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DIISLO2w.js","conditional-requirements-CFM0id0Q.js","cloneDeep-BErNCZCm.js","_Uint8Array-f0PCu9f_.js","isObject-FP1Yky1u.js","ApiExamples-OjY-8mqu.js","usePlaygroundInputsStore-B2HS2hUb.js","shallow-DVFuuIDQ.js","isEqual-DG0UKiQC.js","CodeSnippets-Cy6FBgwN.js","CodeSnippet-D1PtG8ed.js","getApiPlaygroundDisplay-Dkx2eNtL.js","Page-C8Cg25if.js","DynamicMarkdown-BvJIe00T.js","SectionHeading-B0rKYV8d.js","icon-yclzBff4.js","MethodPill-DxA11cCF.js","getPastedJson-CpkIDpMk.js","DuplicateIcon-CFCQNJ-D.js","axios-CsQoIw0U.js","Markdown-CK5C-fmV.js","AssistantPageLink-Cw134Dd-.js","dist-3xM3Qrc7.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}