FirstPromoterInstall

Summary

Track a sale event to FirstPromoter by sending details about the user lead/referral and their transaction to the FirstPromoter tracking API.

Inputs

• email — Email of the user lead/referral. Either Email or UID is required.
• uid — UID (User ID) of the lead/referral. Either Email or UID is required.
• amount (required) — The sale amount in cents. For zero-decimal currencies like JPY, amount should be whole values.
• event_id — Transaction or sale event ID to avoid duplicate sale tracking.
• plan — Customer plan ID from billing provider for plan-level rewards.
• currency — Currency code, required only if different from FirstPromoter settings default currency.
• quantity — Number of subscriptions/items, optional if quantity is 1.
• promo_code — Promo code used by the customer during checkout for tracking.
• mrr — Monthly Recurring Revenue generated by the customer; for zero-decimal currencies, send as whole values, otherwise multiplied by 100.
• tid — Visitor's Tracking ID (tid), typically from the _fprom_tid cookie.
• ref_id — Promoter's referral link token or ID (ref_id), typically from the _fprom_ref cookie.
• skip_email_notification — Boolean flag to skip sending an email notification about the sale; defaults to true.

Output shape

a single JSON response array

Returns the response from the FirstPromoter /track/sale API wrapped in an array as a JSON object. The node throws an error if required conditions are not met (e.g., Email or UID must be present), or if the API call fails unless 'Continue on Fail' is enabled.

Examples

Example 1: Track a new sale with all details

Set 'Email' or 'UID', specify 'Amount' in cents, provide 'Event ID' to ensure uniqueness, optionally add 'Currency', 'Plan', 'Quantity', 'Promo Code', 'MRR', 'TID', 'Ref ID', and set 'Skip Email Notification' as needed.

Links

• n8n community nodes installation guide