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 of content accepted by the API (application/json in most cases)

  • Application key for specific client app

  • Content-Type header

  • Version of the API to be used

  • Authorization header

  • Unique request identifier

Body

required
application/json
  • 10 catering delivery, 11 catering take-out

  • 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: 3
  • Where the event takes place. All fields optional.

  • Properties: 7
  • Required when no customer is signed in.

    Properties: 5

Responses

  • application/json
  • A guest submitted an email that already belongs to a registered customer of this brand. Ask the customer to sign in.

  • Validation failed. Details in data.validations.

Request Example for post/leads
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"
      }
    }
  }
}