POST Create Catering Lead
Submits a catering enquiry. This is the start of the catering chain: the brand's team picks the lead up, prices it, and sends back a quote.
Only catering order types are accepted — 10 catering delivery or 11 catering take-out.
A signed-in customer is attached automatically from the Authorization token. For a guest, send guest_customer_info instead. If a guest's email already belongs to a registered customer of the brand, the request is refused with 401 and the message "Please login to complete quote request creation" — prompt the customer to sign in and submit again.
event_info.event_type is effectively required: the event record is always created, and it validates event_type as required.
Headers
- Type: stringAcceptrequired
Type of content accepted by the API (application/json in most cases)
- Type: stringApplicationrequired
Application key for specific client app
- Type: stringContent
- Type requiredContent-Type header
- Type: stringA
P I - V E R S I O N requiredVersion of the API to be used
- Type: stringAuthorization
Authorization header
- Type: stringX
- Request - I D requiredUnique request identifier
Body
- Type: 10 or 11enumorder
_type required10catering delivery,11catering take-out - Type: integercustomer
_account _id Required only when there is no signed-in customer and no
guest_customer_info. Overwritten from the token when a customer is signed in. - Properties: 3Type: objectdietary
_preferences - Type: objectevent
_address _info Where the event takes place. All fields optional.
- Properties: 7Type: objectevent
_info - Type: objectguest
_customer _info Properties: 5Required when no customer is signed in.
Responses
- application/json
- 401
A guest submitted an email that already belongs to a registered customer of this brand. Ask the customer to sign in.
- 422
Validation failed. Details in
data.validations.
curl https://api-public-demo.menu.app/api/leads \
--request POST \
--header 'Accept: application/json' \
--header 'Application: application-key' \
--header 'Content-Type: application/json' \
--header 'API-VERSION: ' \
--header 'X-Request-ID: c10b4a70-6274-490d-80a0-03e7bb826937' \
--data '{
"order_type": 10,
"guest_customer_info": {
"customer_type_id": 1,
"first_name": "Ana",
"last_name": "Perez",
"email": "ana@example.com",
"phone_number": "+13125550101"
},
"event_info": {
"event_type": "wedding",
"event_description": "Reception for 40",
"event_datetime": "2026-10-02 18:00:00",
"party_size": 40,
"budget": 250000,
"special_instructions": "Use the back entrance"
},
"event_address_info": {
"street_number": "12",
"street_name": "W Adams St",
"postal_code": "60603",
"formatted": "12 W Adams St, Chicago",
"latitude": 41.879,
"longitude": -87.63
},
"dietary_preferences": {
"diet_types": [
"vegan"
],
"allergens": [
"peanut"
]
}
}'
{
"status": "OK",
"code": 200,
"data": {
"lead": {
"id": 91,
"brand_id": 12,
"order_type": 10,
"created_by": "customer",
"status": 1,
"is_qualified": false,
"customer_account": null,
"assigned_rep": null,
"event_info": {
"event_type": "wedding",
"event_datetime": "2026-10-02 18:00:00",
"party_size": 40,
"budget": 250000
},
"guest_customer_info": {
"first_name": "Ana",
"last_name": "Perez",
"email": "ana@example.com",
"phone_number": "+13125550101"
}
}
}
}