# Send RFP (lead data)

Submit RFP (Request For Proposal), also called a lead (group sales lead).

Endpoint: POST /v1/rfp/lead_data
Version: 1.0.0
Security: ApiKeyAuth

## Request fields (application/json):

  - `leadReference` (string)
    Optional partner reference that can be echoed back. If not provided, MeetingPackage will generate one internally.

  - `venues` (array, required)
    List of venue targets referenced by partner-supplied venue identifier.

  - `venues.id` (string, required)
    Stable partner-supplied venue identifier (_not_ a MeetingPackage venue ID). Mapped internally via partner configuration.

  - `accounts` (object)
    Details of the end customer's company and/or the forwarding agency.

  - `accounts.companyAccount` (any)
    Company account details (or null when not provided).

  - `accounts.agencyAccount` (any)
    Agency account details (or null when not provided).

  - `contacts` (object, required)
    Primary human contacts associated with the company and/or agency accounts.
Conditional requirements (not enforced by schema): - If companyAccount is provided, companyContact is required. - If agencyAccount is provided, agencyContact is required. - If neither account is provided, companyContact is required.

  - `contacts.companyContact` (any)
    Company contact details (or null when not provided).

  - `contacts.agencyContact` (any)
    Agency contact details (or null when not provided).

  - `groupRequest` (object, required)

  - `groupRequest.eventDetails` (object, required)

  - `groupRequest.eventDetails.startDate` (string, required)
    ISO date of the first event day.

  - `groupRequest.eventDetails.endDate` (string, required)
    ISO date of the last event day.

  - `groupRequest.eventDetails.dateFlexibility` (string, required)
    Date flexibility for the event.
    Enum: "strict", "flexible"

  - `groupRequest.eventDetails.bookingType` (integer, required)
    Booking type ID (see Get all venue configurations).

  - `groupRequest.eventDetails.bookingName` (string, required)
    Event or opportunity name/title.

  - `groupRequest.eventDetails.attendees` (integer, required)
    Total expected attendees.

  - `groupRequest.opportunity` (object, required)

  - `groupRequest.opportunity.marketSegment` (integer, required)
    Market segment ID (see Get all venue configurations).

  - `groupRequest.opportunity.commissionPercentage` (number)
    Value between 0 and 100. Used to indicate agency commission when a booking is made through an agency.

  - `groupRequest.bedrooms` (any)
    Accommodation requirements keyed by free-text room type name. May be null; treated the same as an empty object.

  - `groupRequest.meetingRooms` (any)
    Meeting room requirements keyed by free-text room name. May be null; treated the same as an empty object.

  - `groupRequest.fAndB` (any)
    Catering requirements keyed by free-text item name. May be null; treated the same as an empty object.

  - `groupRequest.equipment` (any)
    Equipment requirements keyed by free-text equipment name. May be null; treated the same as an empty object.

  - `groupRequest.internalNote` (string)
    Free-text note included with the group request for venue reference. Plain text only.

  - `groupRequest.languageCode` (string)
    ISO language tag.

  - `groupRequest.provisionalHoldDate` (any)
    ISO 8601 date when a provisional hold should expire.

  - `groupRequest.fAndBMinimumSpend` (any)
    Numeric minimum spend requirement in cents.

## Response 200 fields (application/json):

  - `rfp_details` (object, required)

  - `rfp_details.id` (string, required)
    MeetingPackage unique identifier for the submitted RFP/group request.
    Example: "string"

  - `rfp_details.rfps` (array, required)
    One entry per venue targeted by the RFP distribution. Each entry corresponds to the RFP as distributed to a specific venue.

  - `rfp_details.rfps.order_id` (integer, required)
    Unique (order -> proposal -> booking) identifier. This is a key identifier for downstream events and retrieval endpoints (e.g. webhooks and booking retrieval).
    Example: 123456

  - `rfp_details.rfps.mp_venue_id` (integer, required)
    MeetingPackage unique venue identifier.
    Example: 25465

  - `rfp_details.rfps.external_venue_id` (any)
    External venue identifier. May be null depending on integration mapping.
    Example: "VENUE-HELSINKI-001"

## Response 400 fields (application/json):

  - `message` (string)
    Human-readable error message

## Response 401 fields (application/json):

  - `message` (string)
    Human-readable error message

## Response 429 fields (application/json):

  - `message` (string)
    Human-readable error message

## Response 500 fields (application/json):

  - `message` (string)
    Human-readable error message

## Response 503 fields (application/json):

  - `message` (string)
    Human-readable error message