System field shortcodes

To better assist you with routing your leads, Lead Prosper comes prepared with a few system fields that you can implement in your payload that is sent to your buyers, or utilize them in webhooks.

Like the campaign fields, these shortcodes can be added to:

  • real-time and webhook payload builder, for both HTTP or Email delivery
  • direct post and ping/post URLs
  • direct post and ping/post headers
  • most can be used in campaign triggers and buyer webhooks

Available system fields

  • lp_ping_response: returns the full response body of a PING request that was sent to a buyer. Can only be used in PING/POST setups, and only in the POST payload or buyer webhooks. Note: always sent as JSON encoded.
  • lp_ping_response:KEY: extracts a specific KEY from the response body of a PING request that was sent to a buyer. To read more about the KEY, please read this article regarding response parsing.  Can only be used in PING/POST setups, and only in the POST payload or buyer webhooks.
  • lp_post_response: returns the full response body of a POST request that was sent to a buyer. Can only be used in buyer webhooks. Note: always sent as JSON encoded.
  • lp_post_response:KEY: extracts a specific KEY from the response body of a POST request that was sent to a buyer. To read more about the KEY, please read this article regarding response parsing.  Can only be used in buyer webhooks.
  • lp_lead_date: returns the date at which the system received a lead, in the user timezone. Very useful in PING/POST setups, where the date has to be the same in both ping and post. Webhooks and campaign triggers can also benefit from this date. Example output: 2020-01-15 16:34:56. Can be transformed to another format using payload field transformers. Timezone is always the user timezone, cannot be changed. Use lp_lead_date_utc if you need to generate a date in a specific timezone.
  • lp_lead_date_utc: returns the date at which the system received a lead, in the user timezone. Very useful in PING/POST setups, where the date has to be the same in both ping and post. Webhooks and campaign triggers can also benefit from this date. Example output: 2020-01-15 16:34:56. Can be transformed to another format or another timezone using payload field transformers.
  • lp_current_date: returns the current date, in the user timezone. This is different from lp_lead_date, as it does not retain the date between requests related to a specific lead. Example output: 2020-01-15 16:34:56. Can be transformed to another format or another timezone using payload field transformers.
  • lp_current_timestamp: returns the current UTC timestamp. Example output: 1582315643
  • lp_campaign_id: the campaign id
  • lp_supplier_id: the supplier id
  • lp_supplier_name: the supplier nickname or client company name
  • lp_supplier_client_id: the supplier Client ID
  • lp_supplier_client_name: the supplier Client name (first + last)
  • lp_supplier_client_company: the supplier Client company
  • lp_supplier_client_email: the supplier Client email
  • lp_supplier_client_phone: the supplier Client phone number
  • lp_buyer_id: the buyer id
  • lp_buyer_name: the buyer nickname or client company name
  • lp_buyer_client_id: the buyer Client ID
  • lp_buyer_client_name: the buyer Client name (first + last)
  • lp_buyer_client_company: the buyer Client company
  • lp_buyer_client_email: the buyer Client email
  • lp_buyer_client_phone: the buyer Client phone number
  • lp_request_uuid: the internal UUID that Lead Prosper generates. This is the same that is returned back to your supplier in the response and also displayed in the logs
  • lp_lead_id: the generated Lead Prosper lead id
  • lp_lead_status: the lead status: ACCEPTED, DUPLICATED or ERROR
  • lp_lead_error_message: the lead error message. Empty for success. Can only be used in buyer webhooks/campaign triggers.
  • lp_lead_buy_price: the final total buy price of a lead. In a shared Ping/Post Exchange, this will be the price sum of all bids that the supplier accepted to sell to. Default is 0. Otherwise, it will be the price you defined or the price that was calculated based on your pricing rules. Can only be used in buyer webhooks/campaign triggers.
  • lp_lead_sell_price: the final total sell price of a lead across all your buyers. In a shared multi buyer campaign, this will be the price sum of all buyers that accepted the lead. Default is 0. Can only be used in buyer webhooks/campaign triggers.
  • lp_buyer_sell_price: the individual buyer sell price (if the buyer accepted the lead). In a shared campaign, this will reference a specific buyer price and can be different from the lp_lead_sell_price. Default is 0. Can only be used in buyer webhooks/campaign triggers.

Still need help? Contact Us Contact Us