{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/api/booking-flow/customer/lead-booker/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

Lead booker

\n

Before a cart can become an order, it must contain information about the customer (also called the lead booker). The info may be used for invoicing, notifications and even personalizing issued tickets.

\n

The requested info can vary based on the cart items. To see the requested customer info for a cart, make the following request:

\n
\n
\n
Copy
\n
Copied
\n
\n 
curl -X GET '{baseUrl}/carts/{cartUuid}/customer/schema' \\\n-H 'X-Musement-Application: {applicationValue}' \\\n-H 'X-Musement-Version: 3.4.0' \\\n-H 'Authorization: Bearer {accessToken}'
\n
\n

The response returns a JSON schema which describes the requested info for the cart and how it must be submitted. All carts will request the name and email of the lead booker as well opt-in decisions for various newsletters:

\n
\n
\n
Copy
\n
Copied
\n
\n 
{\n\t\"type\": \"object\",\n\t\"title\": \"cart_customer_guest\",\n\t\"properties\": {\n\t\t\"firstname\": {\n\t\t\t\"type\": \"string\",\n\t\t\t\"title\": \"firstname\",\n\t\t\t\"propertyOrder\": 1\n\t\t},\n\t\t\"lastname\": {\n\t\t\t\"type\": \"string\",\n\t\t\t\"title\": \"Cognome\",\n\t\t\t\"propertyOrder\": 2\n\t\t},\n\t\t\"email\": {\n\t\t\t\"type\": \"string\",\n\t\t\t\"title\": \"email\",\n\t\t\t\"format\": \"email\",\n\t\t\t\"propertyOrder\": 3\n\t\t},\n\t\t\"musement_newsletter\": {\n\t\t\t\"enum\": [\n\t\t\t\t\"NO\",\n\t\t\t\t\"YES\"\n\t\t\t],\n\t\t\t\"enum_titles\": [\n\t\t\t\t\"NO\",\n\t\t\t\t\"YES\"\n\t\t\t],\n\t\t\t\"type\": \"string\",\n\t\t\t\"title\": \"musement_newsletter\",\n\t\t\t\"propertyOrder\": 4\n\t\t},\n\t\t\"allow_profiling\": {\n\t\t\t\"enum\": [\n\t\t\t\t\"YES\",\n\t\t\t\t\"NO\"\n\t\t\t],\n\t\t\t\"enum_titles\": [\n\t\t\t\t\"YES\",\n\t\t\t\t\"NO\"\n\t\t\t],\n\t\t\t\"type\": \"string\",\n\t\t\t\"title\": \"allow_profiling\",\n\t\t\t\"propertyOrder\": 5\n\t\t},\n\t\t\"thirdparty_newsletter\": {\n\t\t\t\"enum\": [\n\t\t\t\t\"YES\",\n\t\t\t\t\"NO\"\n\t\t\t],\n\t\t\t\"enum_titles\": [\n\t\t\t\t\"YES\",\n\t\t\t\t\"NO\"\n\t\t\t],\n\t\t\t\"type\": \"string\",\n\t\t\t\"title\": \"thirdparty_newsletter\",\n\t\t\t\"propertyOrder\": 6\n\t\t},\n\t\t\"events_related_newsletter\": {\n\t\t\t\"enum\": [\n\t\t\t\t\"YES\",\n\t\t\t\t\"NO\"\n\t\t\t],\n\t\t\t\"enum_titles\": [\n\t\t\t\t\"YES\",\n\t\t\t\t\"NO\"\n\t\t\t],\n\t\t\t\"type\": \"string\",\n\t\t\t\"title\": \"events_related_newsletter\",\n\t\t\t\"propertyOrder\": 7\n\t\t},\n\t},\n\t\"required\": [\n\t\t\"firstname\",\n\t\t\"lastname\",\n\t\t\"email\",\n\t\t\"musement_newsletter\",\n\t\t\"allow_profiling\",\n\t\t\"thirdparty_newsletter\",\n\t\t\"events_related_newsletter\"\n\t]\n}
\n
\n

In the example above, the firstname, lastname and email properties refer to the lead booker. The newsletter properties are as follows:

\n\n

In the example response, all of the properties accept string values. However, the email property requires an email address while the newsletter properties will only accept a value of YES or NO.

\n

Responses for a cart can vary and may contain extra customer data as well. Since the requested details about customers and the accepted values can change, we recommend using the react-jsonschema-form tool to create user-friendly forms from the endpoint's response. The tool features a live playground where you can paste Musement API responses and see the resulting form in real time.

\n

Once you have collected the required customer information, make the following request to update the cart:

\n
\n
\n
Copy
\n
Copied
\n
\n 
curl -X PUT '{baseUrl}/carts/{cartUuid}/customer' \\\n-H 'X-Musement-Application: {applicationValue}' \\\n-H 'X-Musement-Version: 3.4.0' \\\n-H 'Authorization: Bearer {accessToken}' \\\n-H 'Content-Type: application/json' \\\n--data-raw '{\n\t\"allow_profiling\": \"NO\",\n\t\"email\": \"test@musment.com\",\n\t\"events_related_newsletter\": \"YES\",\n\t\"firstname\": \"Test\",\n\t\"lastname\": \"Test\",\n\t\"musement_newsletter\": \"YES\",\n\t\"thirdparty_newsletter\": \"NO\",\n\t\"events_related_newsletter\": \"NO\"\n}'
\n
","headings":[{"value":"Lead booker","depth":1}]},"contentItem":{"data":{"lastModified":"2025-12-18T16:31:42.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"8e552985-b436-539d-9dfe-0b9912400c58__redocly content/api/booking-flow/customer/lead-booker/","seo":{"title":"Lead booker","description":"Every cart needs a lead booker for contact info and personalizing tickets issued by the Musement API.","image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"api/booking-flow/customer/lead-booker.md","pageBaseUrl":"/api/booking-flow/customer/lead-booker","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Lead booker","id":"lead-booker"}]},"data":{"title":"","redirectFrom":["/guide/booking-flows/set-customer/","/api/partner/booking-flow/customer/set-customer/","/api/partner/booking-flow/customer/lead-booker/"],"seo":{"description":"Every cart needs a lead booker for contact info and personalizing tickets issued by the Musement API."}},"catalogInfo":null,"link":"/api/booking-flow/customer/lead-booker/","sidebarName":"__alternative-sidebar__-data-24763-api-sidebars.yaml","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}