A service is the umbrella record; the sellable variants hang off it as offerings, and only an offering carries price and duration. So a service on its own sells nothing — create at least one offering before publishing. The new service is always DRAFT regardless of what you send; publish it with POST /services//status. Names must be unique within the project per language, compared with case, accents and punctuation normalised away, so a near-duplicate is a 409 rather than a second service. businessModels and attributes can be supplied inline here instead of as follow-up calls. bufferBeforeStartMinutes (0-120, default 0) is spacing before the service starts, for suggestions and checks only. newCategory is written in a separate transaction BEFORE the service, and is not rolled back if the service write then fails — after any error here, retry with categoryId pointing at the category that was already created, not newCategory again.
API key minted in the MarketBox dashboard. Scope is restricted to the projects you select at creation time. Every route needs the key's standard API access (*) except POST /v1/projects/{projectId}/events, which needs events:write; a key without * is refused with 403 CAPABILITY_NOT_GRANTED.
Path Parameters
projectId
string
required
The project (tenant) that owns the resource. Every resource in this API is scoped to a project, and your API key is restricted to the projects it was issued for — a project outside that scope returns 403.
Minimum string length: 1
Example:
"prj_01kv60qgnef2kt3pvqgwmkbzfr"
Body
application/json
Service data
name
object
required
Show child attributes
primaryLanguage
string
required
Minimum string length: 1
description
object
Show child attributes
categoryId
string
newCategory
object
Show child attributes
taxSettings
object
Show child attributes
participantSettings
object
Participant interaction settings: what suppliers and clients may do with, and see on, bookings of this service. Replaced whole on update — send every field, except client.participantDisplay: omitted, it keeps its stored value. Enforced for supplier- and client-role callers; API-key (integrator) calls act for the business and are not restricted by it.
Minutes a supplier needs free before this service starts. Used for suggestions and checks only, never as busy time.
Required range: 0 <= x <= 120
Example:
10
businessModels
object[]
Show child attributes
attributes
object[]
Show child attributes
Response
Service created
data
object
required
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"MarketBox API","description":"Reference and guides for the MarketBox public API","colors":{"primary":"#0087EE","light":"#0087EE","dark":"#0087EE"},"logo":{"light":"https://mintcdn.com/marketboxinc/ajdEqdrEaJkvfx4T/logo/light.svg?fit=max\u0026auto=format\u0026n=ajdEqdrEaJkvfx4T\u0026q=85\u0026s=655948ee6454a1e06bfe0dffda47c7cc","dark":"https://mintcdn.com/marketboxinc/ajdEqdrEaJkvfx4T/logo/dark.svg?fit=max\u0026auto=format\u0026n=ajdEqdrEaJkvfx4T\u0026q=85\u0026s=54826a391e30ee9c27adf963d88a61eb"},"favicon":"https://mintcdn.com/marketboxinc/oL3tvBLJ_yQtNXOS/favicon.svg?fit=max\u0026auto=format\u0026n=oL3tvBLJ_yQtNXOS\u0026q=85\u0026s=01ed3064e8e10cbf6c9a05fae050a805","navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://app.gomarketbox.com/dashboard"}},"footer":{"socials":{"x":"https://x.com/marketboxio","linkedin":"https://linkedin.com/company/marketbox"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"marketboxinc","hasAudioNarration":false,"actualSubdomain":"marketboxinc","customDomains":["docs.gomarketbox.com"],"gitSource":{"type":"github","owner":"gomarketbox","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aff115945eb182701d43e97","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API reference","count":139},{"language":"default","tag":"Endpoints","count":138},{"language":"default","tag":"Guides","count":89},{"language":"default","tag":"Supplier plane","count":38},{"language":"default","tag":"Bookings","count":20},{"language":"default","tag":"Core concepts","count":14},{"language":"default","tag":"Orders","count":13},{"language":"default","tag":"Resources","count":12},{"language":"default","tag":"Suppliers","count":12},{"language":"default","tag":"Build a supplier portal","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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":[]}
{"page":{"pagePath":"api-reference/services/create-a-new-service","slug":"/api-reference/services/create-a-new-service","pageMetadata":{"title":"Create a new service","description":"A service is the umbrella record; the sellable variants hang off it as offerings, and only an offering carries price and duration. So a service on its own sells nothing — create at least one offering before publishing. The new service is always DRAFT regardless of what you send; publish it with POST /services/{serviceId}/status. Names must be unique within the project per language, compared with case, accents and punctuation normalised away, so a near-duplicate is a 409 rather than a second service. `businessModels` and `attributes` can be supplied inline here instead of as follow-up calls. `bufferBeforeStartMinutes` (0-120, default 0) is spacing before the service starts, for suggestions and checks only. `newCategory` is written in a separate transaction BEFORE the service, and is not rolled back if the service write then fails — after any error here, retry with `categoryId` pointing at the category that was already created, not `newCategory` again.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/services","href":"/api-reference/services/create-a-new-service","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"A service is the umbrella record; the sellable variants hang off it as offerings, and only an offering carries price and duration. So a service on its own sells nothing — create at least one offering before publishing. The new service is always DRAFT regardless of what you send; publish it with POST /services/\", \"/status. Names must be unique within the project per language, compared with case, accents and punctuation normalised away, so a near-duplicate is a 409 rather than a second service. \", _jsx(_components.code, {\n children: \"businessModels\"\n }), \" and \", _jsx(_components.code, {\n children: \"attributes\"\n }), \" can be supplied inline here instead of as follow-up calls. \", _jsx(_components.code, {\n children: \"bufferBeforeStartMinutes\"\n }), \" (0-120, default 0) is spacing before the service starts, for suggestions and checks only. \", _jsx(_components.code, {\n children: \"newCategory\"\n }), \" is written in a separate transaction BEFORE the service, and is not rolled back if the service write then fails — after any error here, retry with \", _jsx(_components.code, {\n children: \"categoryId\"\n }), \" pointing at the category that was already created, not \", _jsx(_components.code, {\n children: \"newCategory\"\n }), \" again.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=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 new service","description":"A service is the umbrella record; the sellable variants hang off it as offerings, and only an offering carries price and duration. So a service on its own sells nothing — create at least one offering before publishing. The new service is always DRAFT regardless of what you send; publish it with POST /services/{serviceId}/status. Names must be unique within the project per language, compared with case, accents and punctuation normalised away, so a near-duplicate is a 409 rather than a second service. `businessModels` and `attributes` can be supplied inline here instead of as follow-up calls. `bufferBeforeStartMinutes` (0-120, default 0) is spacing before the service starts, for suggestions and checks only. `newCategory` is written in a separate transaction BEFORE the service, and is not rolled back if the service write then fails — after any error here, retry with `categoryId` pointing at the category that was already created, not `newCategory` again.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/services","href":"/api-reference/services/create-a-new-service","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Services"],"summary":"Create a new service","description":"A service is the umbrella record; the sellable variants hang off it as offerings, and only an offering carries price and duration. So a service on its own sells nothing — create at least one offering before publishing. The new service is always DRAFT regardless of what you send; publish it with POST /services/{serviceId}/status. Names must be unique within the project per language, compared with case, accents and punctuation normalised away, so a near-duplicate is a 409 rather than a second service. `businessModels` and `attributes` can be supplied inline here instead of as follow-up calls. `bufferBeforeStartMinutes` (0-120, default 0) is spacing before the service starts, for suggestions and checks only. `newCategory` is written in a separate transaction BEFORE the service, and is not rolled back if the service write then fails — after any error here, retry with `categoryId` pointing at the category that was already created, not `newCategory` again.","parameters":["d5ae5d1b-b976-43fd-bb28-1e5a7816dbe6"],"requestBody":"fb68ad56-6c9f-441f-addb-18cb8fb42550","responses":{"201":"5c497937-9802-4ba5-a22f-86dfeef5c6f8","400":"4122157b-7b13-4aaf-960c-29296af54fb5","401":"cfc57c6d-2dda-44c5-ae5e-c5d92f26ad72","403":"fbdd7082-5cc8-4725-9eb9-1a12558efad4","409":"a0590041-dc6e-433c-85e2-4b7c81db48fd"},"method":"post","type":"path","servers":["7f0c0cfd-7cba-4616-861f-ca7611ae4010"],"security":["db6d1cf6-4a08-4a4c-92da-023445e576e6"],"path":"/v1/projects/{projectId}/services","baseUrlOptions":["https://apiv2.gomarketbox.com"],"title":"Create a new service","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"d5ae5d1b-b976-43fd-bb28-1e5a7816dbe6":{"schema":{"type":"string","minLength":1,"description":"The project (tenant) that owns the resource. Every resource in this API is scoped to a project, and your API key is restricted to the projects it was issued for — a project outside that scope returns 403.","example":"prj_01kv60qgnef2kt3pvqgwmkbzfr","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"description":"The project (tenant) that owns the resource. Every resource in this API is scoped to a project, and your API key is restricted to the projects it was issued for — a project outside that scope returns 403.","name":"projectId","in":"path"}},"requestBody":{"description":"Service data","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"name.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"name","typeLabel":"object"},"primaryLanguage":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"primaryLanguage","typeLabel":"string"},"description":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"description.additionalProperties","typeLabel":"string"},"default":{},"uniqueKey":"description","typeLabel":"object"},"categoryId":{"type":"string","uniqueKey":"categoryId","typeLabel":"string"},"newCategory":{"type":"object","properties":{"name":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"newCategory.name.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"newCategory.name","typeLabel":"object"},"primaryLanguage":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"newCategory.primaryLanguage","typeLabel":"string"}},"required":["name","primaryLanguage"],"uniqueKey":"newCategory","typeLabel":"object"},"taxSettings":{"type":"object","properties":{"taxable":{"type":"boolean","isRequired":true,"uniqueKey":"taxSettings.taxable","typeLabel":"boolean"},"taxPercentage":{"type":"number","minimum":0,"uniqueKey":"taxSettings.taxPercentage","typeLabel":"number"}},"default":{"taxable":false},"required":["taxable"],"uniqueKey":"taxSettings","typeLabel":"object"},"participantSettings":{"type":"object","properties":{"supplier":{"type":"object","properties":{"canCancelBookings":{"type":"boolean","description":"Suppliers can cancel upcoming sessions they are assigned to.","example":false,"isRequired":true,"uniqueKey":"participantSettings.supplier.canCancelBookings","typeLabel":"boolean"},"cancelNoticeHours":{"type":"integer","minimum":0,"maximum":8760,"description":"Minimum hours before the session starts that this action is still allowed. 0 = allowed any time before the start.","example":24,"isRequired":true,"uniqueKey":"participantSettings.supplier.cancelNoticeHours","typeLabel":"integer"},"canRescheduleBookings":{"type":"boolean","description":"Suppliers can move an upcoming session to another time (same supplier).","example":true,"isRequired":true,"uniqueKey":"participantSettings.supplier.canRescheduleBookings","typeLabel":"boolean"},"rescheduleNoticeHours":{"type":"integer","minimum":0,"maximum":8760,"description":"Minimum hours before the session starts that this action is still allowed. 0 = allowed any time before the start.","example":24,"isRequired":true,"uniqueKey":"participantSettings.supplier.rescheduleNoticeHours","typeLabel":"integer"},"canSeeClientLastName":{"type":"boolean","description":"When false, suppliers see the client first name and last initial only.","example":true,"isRequired":true,"uniqueKey":"participantSettings.supplier.canSeeClientLastName","typeLabel":"boolean"},"canSeeClientEmail":{"type":"boolean","description":"Suppliers can see the client email address.","example":false,"isRequired":true,"uniqueKey":"participantSettings.supplier.canSeeClientEmail","typeLabel":"boolean"},"canSeeClientPhone":{"type":"boolean","description":"Suppliers can see the client phone number.","example":false,"isRequired":true,"uniqueKey":"participantSettings.supplier.canSeeClientPhone","typeLabel":"boolean"}},"required":["canCancelBookings","cancelNoticeHours","canRescheduleBookings","rescheduleNoticeHours","canSeeClientLastName","canSeeClientEmail","canSeeClientPhone"],"description":"What suppliers may do with, and see on, bookings of this service.","example":{"canCancelBookings":false,"cancelNoticeHours":24,"canRescheduleBookings":true,"rescheduleNoticeHours":24,"canSeeClientLastName":true,"canSeeClientEmail":false,"canSeeClientPhone":false},"isRequired":true,"uniqueKey":"participantSettings.supplier","typeLabel":"object"},"client":{"type":"object","properties":{"canRescheduleBookings":{"type":"boolean","description":"Clients can move their own upcoming sessions to another available time.","example":true,"isRequired":true,"uniqueKey":"participantSettings.client.canRescheduleBookings","typeLabel":"boolean"},"rescheduleNoticeHours":{"type":"integer","minimum":0,"maximum":8760,"description":"Minimum hours before the session starts that this action is still allowed. 0 = allowed any time before the start.","example":24,"isRequired":true,"uniqueKey":"participantSettings.client.rescheduleNoticeHours","typeLabel":"integer"},"participantDisplay":{"type":"string","enum":["HIDDEN","FIRST_NAME","FULL"],"description":"How participants are named to clients on their own bookings: FULL (full names), FIRST_NAME (first names only) or HIDDEN (no names; a count such as \"2 participants\").","example":"FULL","uniqueKey":"participantSettings.client.participantDisplay","typeLabel":"enum\u003cstring>"}},"required":["canRescheduleBookings","rescheduleNoticeHours"],"description":"What clients may do with, and see on, their own bookings of this service. Clients cannot cancel.","example":{"canRescheduleBookings":true,"rescheduleNoticeHours":24,"participantDisplay":"FULL"},"isRequired":true,"uniqueKey":"participantSettings.client","typeLabel":"object"}},"required":["supplier","client"],"description":"Participant interaction settings: what suppliers and clients may do with, and see on, bookings of this service. Replaced whole on update — send every field, except `client.participantDisplay`: omitted, it keeps its stored value. Enforced for supplier- and client-role callers; API-key (integrator) calls act for the business and are not restricted by it.","example":{"supplier":{"canCancelBookings":false,"cancelNoticeHours":24,"canRescheduleBookings":true,"rescheduleNoticeHours":24,"canSeeClientLastName":true,"canSeeClientEmail":false,"canSeeClientPhone":false},"client":{"canRescheduleBookings":true,"rescheduleNoticeHours":24,"participantDisplay":"FULL"}},"uniqueKey":"participantSettings","typeLabel":"object"},"bufferBeforeStartMinutes":{"type":"integer","minimum":0,"maximum":120,"default":0,"description":"Minutes a supplier needs free before this service starts. Used for suggestions and checks only, never as busy time.","example":10,"uniqueKey":"bufferBeforeStartMinutes","typeLabel":"integer"},"businessModels":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["SINGLE_BOOKING","PACKAGE","SCHEDULED_PACKAGE","SCHEDULED_SUBSCRIPTION","FLEXIBLE_SUBSCRIPTION"],"description":"How the service is sold. SINGLE_BOOKING is one booking at a time; PACKAGE sells prepaid credits drawn down by later bookings; the SCHEDULED_* and FLEXIBLE_* variants add recurrence and subscription billing. This drives which order item skuType applies.","isRequired":true,"uniqueKey":"businessModels.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"paymentOptions":{"type":"array","items":{"type":"string","enum":["PAY_WHILE_BOOKING","PAY_AFTER_SERVICE_DELIVERED","NO_PAYMENT","PAY_FULL_PRICE_WHILE_PURCHASING","PAY_BEGINNING_OF_MONTH","PAY_END_OF_MONTH"],"uniqueKey":"businessModels.items.[INDEX].paymentOptions.items.[INDEX]","typeLabel":"enum\u003cstring>"},"minItems":1,"isRequired":true,"uniqueKey":"businessModels.items.[INDEX].paymentOptions","typeLabel":"enum\u003cstring>[]"},"fees":{"type":"array","items":{"type":"object","properties":{"feeId":{"type":"string","minLength":1,"description":"Stable identifier for this fee, unique within the business model.","example":"fee_booking","isRequired":true,"uniqueKey":"businessModels.items.[INDEX].fees.items.[INDEX].feeId","typeLabel":"string"},"name":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"businessModels.items.[INDEX].fees.items.[INDEX].name.additionalProperties","typeLabel":"string"},"description":"Buyer-facing label, rendered as its own line on the order summary.","example":{"en":"Booking fee"},"isRequired":true,"uniqueKey":"businessModels.items.[INDEX].fees.items.[INDEX].name","typeLabel":"object"},"calculation":{"type":"string","enum":["FLAT","PERCENT"],"description":"How a service fee is calculated. FLAT charges a fixed amount; PERCENT charges a percentage of the pre-tax total of the lines the fee governs.","example":"FLAT","isRequired":true,"uniqueKey":"businessModels.items.[INDEX].fees.items.[INDEX].calculation","typeLabel":"enum\u003cstring>"},"amount":{"type":"integer","minimum":0,"description":"FLAT fees only. Integer minor units, charged in whatever currency the order is placed in — 2500 is CA$25.00 on a CAD order and US$25.00 on a USD one. Use a PERCENT fee if you need it to scale.","example":2500,"uniqueKey":"businessModels.items.[INDEX].fees.items.[INDEX].amount","typeLabel":"integer"},"percentage":{"type":"number","minimum":0,"maximum":100,"description":"PERCENT fees only. Applied to the pre-tax total of this business model's lines on the order.","example":5,"uniqueKey":"businessModels.items.[INDEX].fees.items.[INDEX].percentage","typeLabel":"number"},"taxable":{"type":"boolean","default":false,"description":"When true, the fee is taxed at the rate of the order lines it is charged alongside (sessions or packages sold under this business model) that are taxed at a positive rate. Lines that are not taxable or taxed at 0% lend no rate; if none of the lines is taxed, the fee is not taxed either.","example":false,"uniqueKey":"businessModels.items.[INDEX].fees.items.[INDEX].taxable","typeLabel":"boolean"}},"required":["feeId","name","calculation"],"uniqueKey":"businessModels.items.[INDEX].fees.items.[INDEX]","typeLabel":"object"},"maxItems":20,"default":[],"description":"Service fees — additional charges attached to this business model, applied to any order line sold under it. Each fee applies once per order regardless of how many lines it governs, and appears as its own entry on the order summary rather than being folded into tax.","example":[{"feeId":"fee_booking","name":{"en":"Booking fee"},"calculation":"FLAT","amount":2500,"taxable":false},{"feeId":"fee_admin","name":{"en":"Admin fee"},"calculation":"PERCENT","percentage":5,"taxable":true}],"uniqueKey":"businessModels.items.[INDEX].fees","typeLabel":"object[]"},"config":{"type":"object","properties":{},"default":{},"additionalProperties":{"oneOf":[{},{"type":"null","uniqueKey":"businessModels.items.[INDEX].config.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"businessModels.items.[INDEX].config.additionalProperties","typeLabel":"null"},"uniqueKey":"businessModels.items.[INDEX].config","typeLabel":"object"}},"required":["type","paymentOptions"],"uniqueKey":"businessModels.items.[INDEX]","typeLabel":"object"},"default":[],"uniqueKey":"businessModels","typeLabel":"object[]"},"attributes":{"type":"array","items":{"type":"object","properties":{"name":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"attributes.items.[INDEX].name.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"attributes.items.[INDEX].name","typeLabel":"object"},"attributeType":{"type":"string","enum":["STRING","NUMBER","ENUM"],"description":"Value type of a service attribute. ENUM attributes carry an allowed-values list.","isRequired":true,"uniqueKey":"attributes.items.[INDEX].attributeType","typeLabel":"enum\u003cstring>"},"enumValues":{"type":"array","items":{"type":"object","properties":{"valueId":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"attributes.items.[INDEX].enumValues.items.[INDEX].valueId","typeLabel":"string"},"label":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"attributes.items.[INDEX].enumValues.items.[INDEX].label.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"attributes.items.[INDEX].enumValues.items.[INDEX].label","typeLabel":"object"}},"required":["valueId","label"],"uniqueKey":"attributes.items.[INDEX].enumValues.items.[INDEX]","typeLabel":"object"},"uniqueKey":"attributes.items.[INDEX].enumValues","typeLabel":"object[]"},"sortOrder":{"type":"integer","minimum":0,"default":0,"uniqueKey":"attributes.items.[INDEX].sortOrder","typeLabel":"integer"}},"required":["name","attributeType"],"uniqueKey":"attributes.items.[INDEX]","typeLabel":"object"},"default":[],"uniqueKey":"attributes","typeLabel":"object[]"}},"required":["name","primaryLanguage"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":{},"primaryLanguage":"\u003cstring>","description":{},"categoryId":"\u003cstring>","taxSettings":{"taxable":false},"participantSettings":{"supplier":{"canCancelBookings":false,"cancelNoticeHours":24,"canRescheduleBookings":true,"rescheduleNoticeHours":24,"canSeeClientLastName":true,"canSeeClientEmail":false,"canSeeClientPhone":false},"client":{"canRescheduleBookings":true,"rescheduleNoticeHours":24,"participantDisplay":"FULL"}},"bufferBeforeStartMinutes":10,"businessModels":[],"attributes":[]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"5c497937-9802-4ba5-a22f-86dfeef5c6f8":{"description":"Service created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"entityType":{"type":"string","enum":["SERVICE"],"isRequired":true,"uniqueKey":"data.entityType","typeLabel":"enum\u003cstring>"},"projectId":{"type":"string","isRequired":true,"uniqueKey":"data.projectId","typeLabel":"string"},"serviceId":{"type":"string","isRequired":true,"uniqueKey":"data.serviceId","typeLabel":"string"},"categoryId":{"type":"string","isRequired":true,"uniqueKey":"data.categoryId","typeLabel":"string"},"categorySnapshot":{"type":"object","properties":{"categoryId":{"type":"string","isRequired":true,"uniqueKey":"data.categorySnapshot.categoryId","typeLabel":"string"},"primaryName":{"type":"string","isRequired":true,"uniqueKey":"data.categorySnapshot.primaryName","typeLabel":"string"},"primaryNameNormalized":{"type":"string","isRequired":true,"uniqueKey":"data.categorySnapshot.primaryNameNormalized","typeLabel":"string"}},"required":["categoryId","primaryName","primaryNameNormalized"],"isRequired":true,"uniqueKey":"data.categorySnapshot","typeLabel":"object"},"name":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"data.name.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.name","typeLabel":"object"},"description":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"data.description.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.description","typeLabel":"object"},"primaryLanguage":{"type":"string","isRequired":true,"uniqueKey":"data.primaryLanguage","typeLabel":"string"},"primaryName":{"type":"string","isRequired":true,"uniqueKey":"data.primaryName","typeLabel":"string"},"primaryNameNormalized":{"type":"string","isRequired":true,"uniqueKey":"data.primaryNameNormalized","typeLabel":"string"},"status":{"type":"string","enum":["DRAFT","LIVE","INACTIVE"],"description":"Lifecycle of the service. Only LIVE services are bookable; DRAFT is unpublished and INACTIVE is retired.","isRequired":true,"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"taxSettings":{"type":"object","properties":{"taxable":{"type":"boolean","isRequired":true,"uniqueKey":"data.taxSettings.taxable","typeLabel":"boolean"},"taxPercentage":{"type":"number","minimum":0,"uniqueKey":"data.taxSettings.taxPercentage","typeLabel":"number"}},"required":["taxable"],"isRequired":true,"uniqueKey":"data.taxSettings","typeLabel":"object"},"counts":{"type":"object","properties":{"offerings":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.counts.offerings","typeLabel":"integer"}},"required":["offerings"],"isRequired":true,"uniqueKey":"data.counts","typeLabel":"object"},"deleted":{"type":"boolean","isRequired":true,"uniqueKey":"data.deleted","typeLabel":"boolean"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.updatedAt","typeLabel":"string\u003cdate-time>"},"createdBy":{"type":"string","isRequired":true,"uniqueKey":"data.createdBy","typeLabel":"string"},"updatedBy":{"type":"string","isRequired":true,"uniqueKey":"data.updatedBy","typeLabel":"string"},"participantSettings":{"type":"object","properties":{"supplier":{"type":"object","properties":{"canCancelBookings":{"type":"boolean","description":"Suppliers can cancel upcoming sessions they are assigned to.","example":false,"isRequired":true,"uniqueKey":"data.participantSettings.supplier.canCancelBookings","typeLabel":"boolean"},"cancelNoticeHours":{"type":"integer","minimum":0,"maximum":8760,"description":"Minimum hours before the session starts that this action is still allowed. 0 = allowed any time before the start.","example":24,"isRequired":true,"uniqueKey":"data.participantSettings.supplier.cancelNoticeHours","typeLabel":"integer"},"canRescheduleBookings":{"type":"boolean","description":"Suppliers can move an upcoming session to another time (same supplier).","example":true,"isRequired":true,"uniqueKey":"data.participantSettings.supplier.canRescheduleBookings","typeLabel":"boolean"},"rescheduleNoticeHours":{"type":"integer","minimum":0,"maximum":8760,"description":"Minimum hours before the session starts that this action is still allowed. 0 = allowed any time before the start.","example":24,"isRequired":true,"uniqueKey":"data.participantSettings.supplier.rescheduleNoticeHours","typeLabel":"integer"},"canSeeClientLastName":{"type":"boolean","description":"When false, suppliers see the client first name and last initial only.","example":true,"isRequired":true,"uniqueKey":"data.participantSettings.supplier.canSeeClientLastName","typeLabel":"boolean"},"canSeeClientEmail":{"type":"boolean","description":"Suppliers can see the client email address.","example":false,"isRequired":true,"uniqueKey":"data.participantSettings.supplier.canSeeClientEmail","typeLabel":"boolean"},"canSeeClientPhone":{"type":"boolean","description":"Suppliers can see the client phone number.","example":false,"isRequired":true,"uniqueKey":"data.participantSettings.supplier.canSeeClientPhone","typeLabel":"boolean"}},"required":["canCancelBookings","cancelNoticeHours","canRescheduleBookings","rescheduleNoticeHours","canSeeClientLastName","canSeeClientEmail","canSeeClientPhone"],"description":"What suppliers may do with, and see on, bookings of this service.","example":{"canCancelBookings":false,"cancelNoticeHours":24,"canRescheduleBookings":true,"rescheduleNoticeHours":24,"canSeeClientLastName":true,"canSeeClientEmail":false,"canSeeClientPhone":false},"isRequired":true,"uniqueKey":"data.participantSettings.supplier","typeLabel":"object"},"client":{"type":"object","properties":{"canRescheduleBookings":{"type":"boolean","description":"Clients can move their own upcoming sessions to another available time.","example":true,"isRequired":true,"uniqueKey":"data.participantSettings.client.canRescheduleBookings","typeLabel":"boolean"},"rescheduleNoticeHours":{"type":"integer","minimum":0,"maximum":8760,"description":"Minimum hours before the session starts that this action is still allowed. 0 = allowed any time before the start.","example":24,"isRequired":true,"uniqueKey":"data.participantSettings.client.rescheduleNoticeHours","typeLabel":"integer"},"participantDisplay":{"type":"string","enum":["HIDDEN","FIRST_NAME","FULL"],"description":"How participants are named to clients on their own bookings: FULL (full names), FIRST_NAME (first names only) or HIDDEN (no names; a count such as \"2 participants\").","example":"FULL","uniqueKey":"data.participantSettings.client.participantDisplay","typeLabel":"enum\u003cstring>"}},"required":["canRescheduleBookings","rescheduleNoticeHours"],"description":"What clients may do with, and see on, their own bookings of this service. Clients cannot cancel.","example":{"canRescheduleBookings":true,"rescheduleNoticeHours":24,"participantDisplay":"FULL"},"isRequired":true,"uniqueKey":"data.participantSettings.client","typeLabel":"object"}},"required":["supplier","client"],"description":"Participant interaction settings: what suppliers and clients may do with, and see on, bookings of this service. Replaced whole on update — send every field, except `client.participantDisplay`: omitted, it keeps its stored value. Enforced for supplier- and client-role callers; API-key (integrator) calls act for the business and are not restricted by it.","example":{"supplier":{"canCancelBookings":false,"cancelNoticeHours":24,"canRescheduleBookings":true,"rescheduleNoticeHours":24,"canSeeClientLastName":true,"canSeeClientEmail":false,"canSeeClientPhone":false},"client":{"canRescheduleBookings":true,"rescheduleNoticeHours":24,"participantDisplay":"FULL"}},"uniqueKey":"data.participantSettings","typeLabel":"object"},"bufferBeforeStartMinutes":{"type":"integer","minimum":0,"maximum":120,"uniqueKey":"data.bufferBeforeStartMinutes","typeLabel":"integer"}},"required":["entityType","projectId","serviceId","categoryId","categorySnapshot","name","description","primaryLanguage","primaryName","primaryNameNormalized","status","taxSettings","counts","deleted","createdAt","updatedAt","createdBy","updatedBy"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["data"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"entityType":"SERVICE","projectId":"\u003cstring>","serviceId":"\u003cstring>","categoryId":"\u003cstring>","categorySnapshot":{"categoryId":"\u003cstring>","primaryName":"\u003cstring>","primaryNameNormalized":"\u003cstring>"},"name":{},"description":{},"primaryLanguage":"\u003cstring>","primaryName":"\u003cstring>","primaryNameNormalized":"\u003cstring>","status":"DRAFT","taxSettings":{"taxable":true,"taxPercentage":1},"counts":{"offerings":1},"deleted":true,"createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","createdBy":"\u003cstring>","updatedBy":"\u003cstring>","participantSettings":{"supplier":{"canCancelBookings":false,"cancelNoticeHours":24,"canRescheduleBookings":true,"rescheduleNoticeHours":24,"canSeeClientLastName":true,"canSeeClientEmail":false,"canSeeClientPhone":false},"client":{"canRescheduleBookings":true,"rescheduleNoticeHours":24,"participantDisplay":"FULL"}},"bufferBeforeStartMinutes":60}}}},"exampleType":"generated"}},"exampleType":"generated"},"4122157b-7b13-4aaf-960c-29296af54fb5":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Stable machine-readable error code, e.g. NOT_FOUND.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description of what went wrong.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"statusCode":{"type":"integer","description":"The HTTP status code of this response.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"requestId":{"type":"string","description":"The id of this request, also returned as the X-Request-Id header. Quote it in a support ticket.","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"required":["code","message","statusCode","requestId"],"example":{"code":"NOT_FOUND","message":"Booking not found","statusCode":404,"requestId":"a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"NOT_FOUND","message":"Booking not found","statusCode":404,"requestId":"a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"}}},"exampleType":"generated"}},"exampleType":"generated"},"cfc57c6d-2dda-44c5-ae5e-c5d92f26ad72":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Stable machine-readable error code, e.g. NOT_FOUND.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description of what went wrong.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"statusCode":{"type":"integer","description":"The HTTP status code of this response.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"requestId":{"type":"string","description":"The id of this request, also returned as the X-Request-Id header. Quote it in a support ticket.","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"required":["code","message","statusCode","requestId"],"example":{"code":"NOT_FOUND","message":"Booking not found","statusCode":404,"requestId":"a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"NOT_FOUND","message":"Booking not found","statusCode":404,"requestId":"a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"}}},"exampleType":"generated"}},"exampleType":"generated"},"fbdd7082-5cc8-4725-9eb9-1a12558efad4":{"description":"API key cannot access this project","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Stable machine-readable error code, e.g. NOT_FOUND.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description of what went wrong.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"statusCode":{"type":"integer","description":"The HTTP status code of this response.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"requestId":{"type":"string","description":"The id of this request, also returned as the X-Request-Id header. Quote it in a support ticket.","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"required":["code","message","statusCode","requestId"],"example":{"code":"NOT_FOUND","message":"Booking not found","statusCode":404,"requestId":"a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"NOT_FOUND","message":"Booking not found","statusCode":404,"requestId":"a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"}}},"exampleType":"generated"}},"exampleType":"generated"},"a0590041-dc6e-433c-85e2-4b7c81db48fd":{"description":"Duplicate name","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Stable machine-readable error code, e.g. NOT_FOUND.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description of what went wrong.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"statusCode":{"type":"integer","description":"The HTTP status code of this response.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"requestId":{"type":"string","description":"The id of this request, also returned as the X-Request-Id header. Quote it in a support ticket.","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"required":["code","message","statusCode","requestId"],"example":{"code":"NOT_FOUND","message":"Booking not found","statusCode":404,"requestId":"a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"NOT_FOUND","message":"Booking not found","statusCode":404,"requestId":"a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"db6d1cf6-4a08-4a4c-92da-023445e576e6":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key minted in the MarketBox dashboard. Scope is restricted to the projects you select at creation time. Every route needs the key's standard API access (`*`) except `POST /v1/projects/{projectId}/events`, which needs `events:write`; a key without `*` is refused with 403 `CAPABILITY_NOT_GRANTED`.","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"7f0c0cfd-7cba-4616-861f-ca7611ae4010":{"url":"https://apiv2.gomarketbox.com","description":"MarketBox Open API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key minted in the MarketBox dashboard. Scope is restricted to the projects you select at creation time. Every route needs the key's standard API access (`*`) except `POST /v1/projects/{projectId}/events`, which needs `events:write`; a key without `*` is refused with 403 `CAPABILITY_NOT_GRANTED`.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","description":"API key minted in the MarketBox dashboard. Scope is restricted to the projects you select at creation time. Every route needs the key's standard API access (`*`) except `POST /v1/projects/{projectId}/events`, which needs `events:write`; a key without `*` is refused with 403 `CAPABILITY_NOT_GRANTED`.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"marketboxinc","siteName":"MarketBox API","title":"Create a new service - MarketBox API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T15:10:27.682Z","originalFileLocation":"api-reference/services/create-a-new-service.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=\"A service is the umbrella record; the sellable variants hang off it as offerings, and only an offering carries price and duration. So a service on its own sells nothing — create at least one offering before publishing. The new service is always DRAFT regardless of what you send; publish it with POST /services/{serviceId}/status. Names must be unique within the project per language, compared with case, accents and punctuation normalised away, so a near-duplicate is a 409 rather than a second service. businessModels and attributes can be supplied inline here instead of as follow-up calls. bufferBeforeStartMinutes (0-120, default 0) is spacing before the service starts, for suggestions and checks only. newCategory is written in a separate transaction BEFORE the service, and is not rolled back if the service write then fails — after any error here, retry with categoryId pointing at the category that was already created, not newCategory again.\">\u003cmeta data-mint-head name=\"application-name\" content=\"MarketBox API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/marketboxinc/etccUjaGielLGJIh/_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/marketboxinc/etccUjaGielLGJIh/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/marketboxinc/etccUjaGielLGJIh/_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/marketboxinc/etccUjaGielLGJIh/_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/marketboxinc/etccUjaGielLGJIh/_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/marketboxinc/etccUjaGielLGJIh/_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/marketboxinc/etccUjaGielLGJIh/_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/marketboxinc/etccUjaGielLGJIh/_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/marketboxinc/etccUjaGielLGJIh/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a new service - MarketBox API\">\u003cmeta data-mint-head property=\"og:description\" content=\"A service is the umbrella record; the sellable variants hang off it as offerings, and only an offering carries price and duration. So a service on its own sells nothing — create at least one offering before publishing. The new service is always DRAFT regardless of what you send; publish it with POST /services/{serviceId}/status. Names must be unique within the project per language, compared with case, accents and punctuation normalised away, so a near-duplicate is a 409 rather than a second service. businessModels and attributes can be supplied inline here instead of as follow-up calls. bufferBeforeStartMinutes (0-120, default 0) is spacing before the service starts, for suggestions and checks only. newCategory is written in a separate transaction BEFORE the service, and is not rolled back if the service write then fails — after any error here, retry with categoryId pointing at the category that was already created, not newCategory again.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"MarketBox API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.gomarketbox.com/api-reference/services/create-a-new-service\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://marketboxinc.mintlify.site/_mintlify/api/og/v2?division=Services\u0026amp;title=Create+a+new+service\u0026amp;description=A+service+is+the+umbrella+record%3B+the+sellable+variants+hang+off+it+as+offerings%2C+and+only+an+offering+carries+price+and+duration.+So+a+service+on+its+own+sells\u0026amp;theme=3a79fb7765978cda15c7035f\u0026amp;signature=c3a1c8409dbaad75b791b17326f0a57467c34a6d286c610a936fac261b1f206f\">\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 new service - MarketBox API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"A service is the umbrella record; the sellable variants hang off it as offerings, and only an offering carries price and duration. So a service on its own sells nothing — create at least one offering before publishing. The new service is always DRAFT regardless of what you send; publish it with POST /services/{serviceId}/status. Names must be unique within the project per language, compared with case, accents and punctuation normalised away, so a near-duplicate is a 409 rather than a second service. businessModels and attributes can be supplied inline here instead of as follow-up calls. bufferBeforeStartMinutes (0-120, default 0) is spacing before the service starts, for suggestions and checks only. newCategory is written in a separate transaction BEFORE the service, and is not rolled back if the service write then fails — after any error here, retry with categoryId pointing at the category that was already created, not newCategory again.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://marketboxinc.mintlify.site/_mintlify/api/og/v2?division=Services\u0026amp;title=Create+a+new+service\u0026amp;description=A+service+is+the+umbrella+record%3B+the+sellable+variants+hang+off+it+as+offerings%2C+and+only+an+offering+carries+price+and+duration.+So+a+service+on+its+own+sells\u0026amp;theme=3a79fb7765978cda15c7035f\u0026amp;signature=c3a1c8409dbaad75b791b17326f0a57467c34a6d286c610a936fac261b1f206f\">\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/marketboxinc/etccUjaGielLGJIh/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"MarketBox API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0087EE\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.gomarketbox.com/api-reference/services/create-a-new-service\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/services/create-a-new-service.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.gomarketbox.com/#organization\",\"name\":\"MarketBox API\",\"url\":\"https://docs.gomarketbox.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/marketboxinc/ajdEqdrEaJkvfx4T/logo/light.svg?fit=max\u0026auto=format\u0026n=ajdEqdrEaJkvfx4T\u0026q=85\u0026s=655948ee6454a1e06bfe0dffda47c7cc\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.gomarketbox.com#website\",\"name\":\"MarketBox API\",\"url\":\"https://docs.gomarketbox.com\",\"publisher\":{\"@id\":\"https://docs.gomarketbox.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.gomarketbox.com/api-reference/services/create-a-new-service#webpage\",\"url\":\"https://docs.gomarketbox.com/api-reference/services/create-a-new-service\",\"name\":\"Create a new service\",\"description\":\"A service is the umbrella record; the sellable variants hang off it as offerings, and only an offering carries price and duration. So a service on its own sells nothing — create at least one offering before publishing. The new service is always DRAFT regardless of what you send; publish it with POST /services/{serviceId}/status. Names must be unique within the project per language, compared with case, accents and punctuation normalised away, so a near-duplicate is a 409 rather than a second service. businessModels and attributes can be supplied inline here instead of as follow-up calls. bufferBeforeStartMinutes (0-120, default 0) is spacing before the service starts, for suggestions and checks only. newCategory is written in a separate transaction BEFORE the service, and is not rolled back if the service write then fails — after any error here, retry with categoryId pointing at the category that was already created, not newCategory again.\",\"dateModified\":\"2026-11-19T15:10:27.682Z\",\"isPartOf\":{\"@id\":\"https://docs.gomarketbox.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gomarketbox.com/api-reference/services/create-a-new-service#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gomarketbox.com/api-reference/services/create-a-new-service#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.gomarketbox.com/api-reference/events/report-site-events-straight-from-the-browser-publishable-key-no-response-body\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Services\",\"item\":\"https://docs.gomarketbox.com/api-reference/services/list-services-for-a-project\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create a new service\",\"item\":\"https://docs.gomarketbox.com/api-reference/services/create-a-new-service\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.gomarketbox.com/api-reference/services/create-a-new-service#apireference\",\"headline\":\"Create a new service\",\"name\":\"Create a new service\",\"description\":\"A service is the umbrella record; the sellable variants hang off it as offerings, and only an offering carries price and duration. So a service on its own sells nothing — create at least one offering before publishing. The new service is always DRAFT regardless of what you send; publish it with POST /services/{serviceId}/status. Names must be unique within the project per language, compared with case, accents and punctuation normalised away, so a near-duplicate is a 409 rather than a second service. businessModels and attributes can be supplied inline here instead of as follow-up calls. bufferBeforeStartMinutes (0-120, default 0) is spacing before the service starts, for suggestions and checks only. newCategory is written in a separate transaction BEFORE the service, and is not rolled back if the service write then fails — after any error here, retry with categoryId pointing at the category that was already created, not newCategory again.\",\"url\":\"https://docs.gomarketbox.com/api-reference/services/create-a-new-service\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gomarketbox.com/api-reference/services/create-a-new-service#webpage\"},\"dateModified\":\"2026-11-19T15:10:27.682Z\",\"publisher\":{\"@id\":\"https://docs.gomarketbox.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.gomarketbox.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"MarketBox API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"MarketBox API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/services/create-a-new-service.md","siteName":"MarketBox API","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"API reference","href":"/api-reference/introduction"}]},{"group":"Endpoints","pages":[{"group":"Events","pages":[{"title":"Report site events straight from the browser (publishable key, no response body)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/events/beacon","href":"/api-reference/events/report-site-events-straight-from-the-browser-publishable-key-no-response-body"},{"title":"Report what your site showed: rendered searches, lists, impressions, clicks, profile views","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/events","href":"/api-reference/events/report-what-your-site-showed:-rendered-searches-lists-impressions-clicks-profile-views"}]},{"group":"Supplier plane","pages":[{"title":"Whether the signed-in person may use the supplier plane, and why not","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/access","href":"/api-reference/supplier-plane/whether-the-signed-in-person-may-use-the-supplier-plane-and-why-not"},{"title":"List the signed-in supplier’s bookings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/bookings","href":"/api-reference/supplier-plane/list-the-signed-in-supplier’s-bookings"},{"title":"One of the signed-in supplier’s bookings, with services and participants","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/bookings/{bookingId}","href":"/api-reference/supplier-plane/one-of-the-signed-in-supplier’s-bookings-with-services-and-participants"},{"title":"Move one of the signed-in supplier’s bookings to another time","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/suppliers/me/bookings/{bookingId}","href":"/api-reference/supplier-plane/move-one-of-the-signed-in-supplier’s-bookings-to-another-time"},{"title":"The signed-in supplier’s own attendance report on one of their bookings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/bookings/{bookingId}/reports","href":"/api-reference/supplier-plane/the-signed-in-supplier’s-own-attendance-report-on-one-of-their-bookings"},{"title":"File the signed-in supplier’s attendance report on one of their bookings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/bookings/{bookingId}/reports","href":"/api-reference/supplier-plane/file-the-signed-in-supplier’s-attendance-report-on-one-of-their-bookings"},{"title":"Cancel one of the signed-in supplier’s bookings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/bookings/{bookingId}/cancel","href":"/api-reference/supplier-plane/cancel-one-of-the-signed-in-supplier’s-bookings"},{"title":"List the signed-in supplier’s schedules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/schedules","href":"/api-reference/supplier-plane/list-the-signed-in-supplier’s-schedules"},{"title":"Create a schedule for the signed-in supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/schedules","href":"/api-reference/supplier-plane/create-a-schedule-for-the-signed-in-supplier"},{"title":"Get one of the signed-in supplier’s schedules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/schedules/{scheduleId}","href":"/api-reference/supplier-plane/get-one-of-the-signed-in-supplier’s-schedules"},{"title":"Delete one of the signed-in supplier’s schedules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/me/schedules/{scheduleId}","href":"/api-reference/supplier-plane/delete-one-of-the-signed-in-supplier’s-schedules"},{"title":"Update one of the signed-in supplier’s schedules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/suppliers/me/schedules/{scheduleId}","href":"/api-reference/supplier-plane/update-one-of-the-signed-in-supplier’s-schedules"},{"title":"Clone one of the signed-in supplier’s schedules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/schedules/{scheduleId}/clone","href":"/api-reference/supplier-plane/clone-one-of-the-signed-in-supplier’s-schedules"},{"title":"Move the signed-in supplier’s schedules and blocked times to their profile zone","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/availability-timezone/apply-profile","href":"/api-reference/supplier-plane/move-the-signed-in-supplier’s-schedules-and-blocked-times-to-their-profile-zone"},{"title":"List the signed-in supplier’s blocked times","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/blocked-times","href":"/api-reference/supplier-plane/list-the-signed-in-supplier’s-blocked-times"},{"title":"Create a blocked time for the signed-in supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/blocked-times","href":"/api-reference/supplier-plane/create-a-blocked-time-for-the-signed-in-supplier"},{"title":"Get one of the signed-in supplier’s blocked times","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/blocked-times/{blockedTimeId}","href":"/api-reference/supplier-plane/get-one-of-the-signed-in-supplier’s-blocked-times"},{"title":"Delete one of the signed-in supplier’s blocked times","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/me/blocked-times/{blockedTimeId}","href":"/api-reference/supplier-plane/delete-one-of-the-signed-in-supplier’s-blocked-times"},{"title":"Update one of the signed-in supplier’s blocked times","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/suppliers/me/blocked-times/{blockedTimeId}","href":"/api-reference/supplier-plane/update-one-of-the-signed-in-supplier’s-blocked-times"},{"title":"The signed-in supplier’s Week \u0026 demand view","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/demand","href":"/api-reference/supplier-plane/the-signed-in-supplier’s-week-\u0026-demand-view"},{"title":"Dismiss one of the signed-in supplier’s demand suggestions for 90 days","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/demand/suggestions/{key}/dismiss","href":"/api-reference/supplier-plane/dismiss-one-of-the-signed-in-supplier’s-demand-suggestions-for-90-days"},{"title":"Undo a dismissal: the suggestion shows again when the data still supports it","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/me/demand/suggestions/{key}/dismiss","href":"/api-reference/supplier-plane/undo-a-dismissal:-the-suggestion-shows-again-when-the-data-still-supports-it"},{"title":"The signed-in supplier’s Search insights","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/search-insights","href":"/api-reference/supplier-plane/the-signed-in-supplier’s-search-insights"},{"title":"The signed-in supplier’s own profile","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me","href":"/api-reference/supplier-plane/the-signed-in-supplier’s-own-profile"},{"title":"Update the signed-in supplier’s own profile","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/suppliers/me","href":"/api-reference/supplier-plane/update-the-signed-in-supplier’s-own-profile"},{"title":"Get a presigned URL to upload the signed-in supplier’s photo","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/avatar/upload-url","href":"/api-reference/supplier-plane/get-a-presigned-url-to-upload-the-signed-in-supplier’s-photo"},{"title":"Attach the uploaded photo to the signed-in supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/projects/{projectId}/suppliers/me/avatar","href":"/api-reference/supplier-plane/attach-the-uploaded-photo-to-the-signed-in-supplier"},{"title":"Remove the signed-in supplier’s photo","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/me/avatar","href":"/api-reference/supplier-plane/remove-the-signed-in-supplier’s-photo"},{"title":"List the signed-in supplier’s travel zones","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/travel-zones","href":"/api-reference/supplier-plane/list-the-signed-in-supplier’s-travel-zones"},{"title":"Create a travel zone for the signed-in supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/travel-zones","href":"/api-reference/supplier-plane/create-a-travel-zone-for-the-signed-in-supplier"},{"title":"Get one of the signed-in supplier’s travel zones","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/travel-zones/{travelZoneId}","href":"/api-reference/supplier-plane/get-one-of-the-signed-in-supplier’s-travel-zones"},{"title":"Delete one of the signed-in supplier’s travel zones","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/me/travel-zones/{travelZoneId}","href":"/api-reference/supplier-plane/delete-one-of-the-signed-in-supplier’s-travel-zones"},{"title":"Update one of the signed-in supplier’s travel zones","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/suppliers/me/travel-zones/{travelZoneId}","href":"/api-reference/supplier-plane/update-one-of-the-signed-in-supplier’s-travel-zones"},{"title":"List the venues the signed-in supplier may be scheduled at","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/locations","href":"/api-reference/supplier-plane/list-the-venues-the-signed-in-supplier-may-be-scheduled-at"},{"title":"List the signed-in supplier’s alerts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/alerts","href":"/api-reference/supplier-plane/list-the-signed-in-supplier’s-alerts"},{"title":"The signed-in supplier’s unread count and open conditions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/alerts/summary","href":"/api-reference/supplier-plane/the-signed-in-supplier’s-unread-count-and-open-conditions"},{"title":"Mark all of the signed-in supplier’s alerts read","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/alerts/read-all","href":"/api-reference/supplier-plane/mark-all-of-the-signed-in-supplier’s-alerts-read"},{"title":"Mark one of the signed-in supplier’s alerts read","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/alerts/{alertId}/read","href":"/api-reference/supplier-plane/mark-one-of-the-signed-in-supplier’s-alerts-read"}]},{"group":"Bookings","pages":[{"title":"List bookings for a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings","href":"/api-reference/bookings/list-bookings-for-a-project"},{"title":"Create a new booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/bookings","href":"/api-reference/bookings/create-a-new-booking"},{"title":"Get a booking by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings/{bookingId}","href":"/api-reference/bookings/get-a-booking-by-id"},{"title":"Soft-delete a booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/bookings/{bookingId}","href":"/api-reference/bookings/soft-delete-a-booking"},{"title":"Reschedule or update a booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/bookings/{bookingId}","href":"/api-reference/bookings/reschedule-or-update-a-booking"},{"title":"Get a booking with its services, participants, notes, reports and party names","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings/{bookingId}/aggregate","href":"/api-reference/bookings/get-a-booking-with-its-services-participants-notes-reports-and-party-names"},{"title":"Change a booking status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/bookings/{bookingId}/status","href":"/api-reference/bookings/change-a-booking-status"},{"title":"List bookings for a supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/{supplierId}/bookings","href":"/api-reference/bookings/list-bookings-for-a-supplier"},{"title":"List bookings for a client","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/clients/{clientId}/bookings","href":"/api-reference/bookings/list-bookings-for-a-client"},{"title":"List participants on a booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings/{bookingId}/participants","href":"/api-reference/bookings/list-participants-on-a-booking"},{"title":"Register a participant on a booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/bookings/{bookingId}/participants","href":"/api-reference/bookings/register-a-participant-on-a-booking"},{"title":"Get a single booking participant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings/{bookingId}/participants/{clientId}","href":"/api-reference/bookings/get-a-single-booking-participant"},{"title":"Cancel a booking participant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/bookings/{bookingId}/participants/{clientId}","href":"/api-reference/bookings/cancel-a-booking-participant"},{"title":"Check in a participant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/bookings/{bookingId}/participants/{clientId}/check-in","href":"/api-reference/bookings/check-in-a-participant"},{"title":"List booking notes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings/{bookingId}/notes","href":"/api-reference/bookings/list-booking-notes"},{"title":"Create a booking note","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/bookings/{bookingId}/notes","href":"/api-reference/bookings/create-a-booking-note"},{"title":"Delete a booking note","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/bookings/{bookingId}/notes/{noteId}","href":"/api-reference/bookings/delete-a-booking-note"},{"title":"Update a booking note","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/bookings/{bookingId}/notes/{noteId}","href":"/api-reference/bookings/update-a-booking-note"},{"title":"List the reports filed on a booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings/{bookingId}/reports","href":"/api-reference/bookings/list-the-reports-filed-on-a-booking"},{"title":"File one side's report on a booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/bookings/{bookingId}/reports","href":"/api-reference/bookings/file-one-sides-report-on-a-booking"}]},{"group":"Reviews","pages":[{"title":"List every review linked to a booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings/{bookingId}/reviews","href":"/api-reference/reviews/list-every-review-linked-to-a-booking"},{"title":"Review a booking, in either direction","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/bookings/{bookingId}/reviews","href":"/api-reference/reviews/review-a-booking-in-either-direction"},{"title":"List reviews for a project (newest first); filter by supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/reviews","href":"/api-reference/reviews/list-reviews-for-a-project-newest-first;-filter-by-supplier"},{"title":"Create a supplier review (1–5 star rating with optional comment)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/reviews","href":"/api-reference/reviews/create-a-supplier-review-1–5-star-rating-with-optional-comment"},{"title":"List the reviews written about a client","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/clients/{clientId}/reviews","href":"/api-reference/reviews/list-the-reviews-written-about-a-client"},{"title":"Get a client's average rating and review count","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/clients/{clientId}/review-summary","href":"/api-reference/reviews/get-a-clients-average-rating-and-review-count"},{"title":"Get a supplier's average rating and review count","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/{supplierId}/review-summary","href":"/api-reference/reviews/get-a-suppliers-average-rating-and-review-count"}]},{"group":"Orders","pages":[{"title":"List orders by status, by payment method, or every order in a date range","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/orders","href":"/api-reference/orders/list-orders-by-status-by-payment-method-or-every-order-in-a-date-range"},{"title":"Create a new order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/orders","href":"/api-reference/orders/create-a-new-order"},{"title":"Get an order by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/orders/{orderId}","href":"/api-reference/orders/get-an-order-by-id"},{"title":"Soft-delete an order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/orders/{orderId}","href":"/api-reference/orders/soft-delete-an-order"},{"title":"Update an order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/orders/{orderId}","href":"/api-reference/orders/update-an-order"},{"title":"Get an order with its items","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/orders/{orderId}/aggregate","href":"/api-reference/orders/get-an-order-with-its-items"},{"title":"List orders for a client","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/clients/{clientId}/orders","href":"/api-reference/orders/list-orders-for-a-client"},{"title":"Change order status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/orders/{orderId}/status","href":"/api-reference/orders/change-order-status"},{"title":"Add an item to an order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/orders/{orderId}/items","href":"/api-reference/orders/add-an-item-to-an-order"},{"title":"Remove an order item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/orders/{orderId}/items/{orderItemId}","href":"/api-reference/orders/remove-an-order-item"},{"title":"Update an order item quantity","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/orders/{orderId}/items/{orderItemId}","href":"/api-reference/orders/update-an-order-item-quantity"},{"title":"List the bookings created for a PACKAGE order item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/orders/{orderId}/package-bookings","href":"/api-reference/orders/list-the-bookings-created-for-a-package-order-item"},{"title":"Create N package sessions atomically (or best-effort) from one PACKAGE order item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/orders/{orderId}/package-bookings","href":"/api-reference/orders/create-n-package-sessions-atomically-or-best-effort-from-one-package-order-item"}]},{"group":"Suppliers","pages":[{"title":"List suppliers for a project, enriched with services and skills; filter by service/skill/region/point","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers","href":"/api-reference/suppliers/list-suppliers-for-a-project-enriched-with-services-and-skills;-filter-by-serviceskillregionpoint"},{"title":"Create a supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers","href":"/api-reference/suppliers/create-a-supplier"},{"title":"One supplier in full: profile, services, skills, locations, rating and working hours","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/{supplierId}","href":"/api-reference/suppliers/one-supplier-in-full:-profile-services-skills-locations-rating-and-working-hours"},{"title":"Update a supplier; sync its service/skill mappings when arrays are supplied","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/projects/{projectId}/suppliers/{supplierId}","href":"/api-reference/suppliers/update-a-supplier;-sync-its-serviceskill-mappings-when-arrays-are-supplied"},{"title":"Soft-delete a supplier (cascade-removes its mappings and avatar)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/{supplierId}","href":"/api-reference/suppliers/soft-delete-a-supplier-cascade-removes-its-mappings-and-avatar"},{"title":"Add a service to a supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/{supplierId}/services/{serviceId}","href":"/api-reference/suppliers/add-a-service-to-a-supplier"},{"title":"Remove a service from a supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/{supplierId}/services/{serviceId}","href":"/api-reference/suppliers/remove-a-service-from-a-supplier"},{"title":"Add a skill to a supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/{supplierId}/skills/{skillId}","href":"/api-reference/suppliers/add-a-skill-to-a-supplier"},{"title":"Remove a skill from a supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/{supplierId}/skills/{skillId}","href":"/api-reference/suppliers/remove-a-skill-from-a-supplier"},{"title":"Get a presigned URL to upload a supplier avatar","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/{supplierId}/avatar/upload-url","href":"/api-reference/suppliers/get-a-presigned-url-to-upload-a-supplier-avatar"},{"title":"Confirm an uploaded avatar and attach it to the supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/projects/{projectId}/suppliers/{supplierId}/avatar","href":"/api-reference/suppliers/confirm-an-uploaded-avatar-and-attach-it-to-the-supplier"},{"title":"Remove a supplier's avatar","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/{supplierId}/avatar","href":"/api-reference/suppliers/remove-a-suppliers-avatar"}]},{"group":"Availability","pages":[{"title":"Find suppliers + suggested/open slots for a service, location and window","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/availability/search","href":"/api-reference/availability/find-suppliers-+-suggestedopen-slots-for-a-service-location-and-window"},{"title":"Generate clustered time slots from suppliers + engine config","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/availability/time-slots","href":"/api-reference/availability/generate-clustered-time-slots-from-suppliers-+-engine-config"},{"title":"Supplier-centric availability: paginated suppliers, each with open slots grouped by day","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/availability/suppliers","href":"/api-reference/availability/supplier-centric-availability:-paginated-suppliers-each-with-open-slots-grouped-by-day"},{"title":"Build a single-supplier N-session package slate (policy-driven), persisting suggestions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/availability/package-slate","href":"/api-reference/availability/build-a-single-supplier-n-session-package-slate-policy-driven-persisting-suggestions"},{"title":"List a service's packages, each with a ready-to-book slate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/availability/package-options","href":"/api-reference/availability/list-a-services-packages-each-with-a-ready-to-book-slate"}]},{"group":"Suggestions","pages":[{"title":"Reschedule a suggested slot to a new time (server-validated), refreshing its slate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suggestions/slots/{slotId}/reschedule","href":"/api-reference/suggestions/reschedule-a-suggested-slot-to-a-new-time-server-validated-refreshing-its-slate"}]},{"group":"Holds","pages":[{"title":"Hold supplier time during checkout — a single session, or a whole package slate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/holds","href":"/api-reference/holds/hold-supplier-time-during-checkout-—-a-single-session-or-a-whole-package-slate"},{"title":"Read a hold — its status, its heldUntil, and the supplier time it claims","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/holds/{reservationId}","href":"/api-reference/holds/read-a-hold-—-its-status-its-helduntil-and-the-supplier-time-it-claims"},{"title":"Release a hold (HELD → RELEASED) — idempotent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/holds/{reservationId}/release","href":"/api-reference/holds/release-a-hold-held-→-released-—-idempotent"},{"title":"Convert a hold into confirmed bookings (the idempotent purchase hook)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/holds/{reservationId}/convert","href":"/api-reference/holds/convert-a-hold-into-confirmed-bookings-the-idempotent-purchase-hook"}]},{"group":"Clients","pages":[{"title":"Onboard the authenticated client to a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/clients/me","href":"/api-reference/clients/onboard-the-authenticated-client-to-a-project"},{"title":"Update the authenticated client's contact details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/clients/me","href":"/api-reference/clients/update-the-authenticated-clients-contact-details"},{"title":"Get the authenticated client's package credits","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/clients/me/credits","href":"/api-reference/clients/get-the-authenticated-clients-package-credits"},{"title":"Book sessions from the authenticated client's own package credit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/clients/me/orders/{orderId}/package-bookings","href":"/api-reference/clients/book-sessions-from-the-authenticated-clients-own-package-credit"},{"title":"Add a service address to the caller's client profile","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/clients/me/addresses","href":"/api-reference/clients/add-a-service-address-to-the-callers-client-profile"},{"title":"Remove one of the caller's addresses","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/clients/me/addresses/{addressId}","href":"/api-reference/clients/remove-one-of-the-callers-addresses"},{"title":"Update one of the caller's addresses","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/clients/me/addresses/{addressId}","href":"/api-reference/clients/update-one-of-the-callers-addresses"},{"title":"Set the caller's default address","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/projects/{projectId}/clients/me/addresses/{addressId}/default","href":"/api-reference/clients/set-the-callers-default-address"}]},{"group":"Services","pages":[{"title":"List services for a project","description":"The project catalogue, sorted by name within each status. Unlike most list endpoints this one is not paginated: a project holds few enough services to return in one response, so `nextCursor` is always null and there is no `limit`. All three statuses are included unless you filter — pass `status=LIVE` for anything client-facing, or DRAFT services that were never meant to be public will appear in your storefront. Soft-deleted services are never returned.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/services","href":"/api-reference/services/list-services-for-a-project"},{"title":"Create a new service","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/services","href":"/api-reference/services/create-a-new-service"},{"title":"Get a service by ID","description":"The service header on its own — its offerings, business models and attributes are separate resources and are not embedded here, so pricing and duration require a second call to the offerings endpoint. `counts.offerings` tells you whether that call is worth making. A soft-deleted service is a 404, not a tombstone.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/services/{serviceId}","href":"/api-reference/services/get-a-service-by-id"},{"title":"Update a service","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/projects/{projectId}/services/{serviceId}","href":"/api-reference/services/update-a-service"},{"title":"Soft delete a service","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/services/{serviceId}","href":"/api-reference/services/soft-delete-a-service"},{"title":"Change service status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/services/{serviceId}/status","href":"/api-reference/services/change-service-status"}]},{"group":"ServiceBusinessModels","pages":[{"title":"List business models for a service","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/services/{serviceId}/business-models","href":"/api-reference/servicebusinessmodels/list-business-models-for-a-service"},{"title":"Add a business model to a service","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/services/{serviceId}/business-models","href":"/api-reference/servicebusinessmodels/add-a-business-model-to-a-service"},{"title":"Update a business model","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/projects/{projectId}/services/{serviceId}/business-models/{businessModelId}","href":"/api-reference/servicebusinessmodels/update-a-business-model"},{"title":"Toggle business model active status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/services/{serviceId}/business-models/{businessModelId}/status","href":"/api-reference/servicebusinessmodels/toggle-business-model-active-status"}]},{"group":"ServiceOfferings","pages":[{"title":"List offerings for a service","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/services/{serviceId}/offerings","href":"/api-reference/serviceofferings/list-offerings-for-a-service"},{"title":"Add an offering to a service","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/services/{serviceId}/offerings","href":"/api-reference/serviceofferings/add-an-offering-to-a-service"},{"title":"Get an offering","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/services/{serviceId}/offerings/{offeringId}","href":"/api-reference/serviceofferings/get-an-offering"},{"title":"Update an offering","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/projects/{projectId}/services/{serviceId}/offerings/{offeringId}","href":"/api-reference/serviceofferings/update-an-offering"},{"title":"Soft delete an offering","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/services/{serviceId}/offerings/{offeringId}","href":"/api-reference/serviceofferings/soft-delete-an-offering"},{"title":"Change offering status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/services/{serviceId}/offerings/{offeringId}/status","href":"/api-reference/serviceofferings/change-offering-status"}]},{"group":"ServicePackages","pages":[{"title":"List packages for an offering (storefront)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/services/{serviceId}/offerings/{offeringId}/packages","href":"/api-reference/servicepackages/list-packages-for-an-offering-storefront"},{"title":"Create a sellable package (bundle) for an offering","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/services/{serviceId}/offerings/{offeringId}/packages","href":"/api-reference/servicepackages/create-a-sellable-package-bundle-for-an-offering"},{"title":"List every package for a service (storefront discovery)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/services/{serviceId}/packages","href":"/api-reference/servicepackages/list-every-package-for-a-service-storefront-discovery"},{"title":"Get a package by id","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/packages/{packageId}","href":"/api-reference/servicepackages/get-a-package-by-id"},{"title":"Update a package","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/projects/{projectId}/packages/{packageId}","href":"/api-reference/servicepackages/update-a-package"},{"title":"Change package status (rewrites the storefront sort key)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/packages/{packageId}/status","href":"/api-reference/servicepackages/change-package-status-rewrites-the-storefront-sort-key"}]},{"group":"Locations","pages":[{"title":"List locations for a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/locations","href":"/api-reference/locations/list-locations-for-a-project"},{"title":"Get a location by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/locations/{locationId}","href":"/api-reference/locations/get-a-location-by-id"}]},{"group":"Skills","pages":[{"title":"List skills for a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/skills","href":"/api-reference/skills/list-skills-for-a-project"}]},{"group":"Transactions","pages":[{"title":"Record a manual (cash/external/comp) transaction against an order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/orders/{orderId}/transactions","href":"/api-reference/transactions/record-a-manual-cashexternalcomp-transaction-against-an-order"},{"title":"List transactions (filter by order, client, or status)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/transactions","href":"/api-reference/transactions/list-transactions-filter-by-order-client-or-status"},{"title":"Create a Stripe PaymentIntent for an order (client-side confirmation)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/orders/{orderId}/payment-intent","href":"/api-reference/transactions/create-a-stripe-paymentintent-for-an-order-client-side-confirmation"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/overview"}]}]},"basePath":"","title":"Create a new service - MarketBox API","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}