How to Map Intake Endpoint Fields

Note: this is a plain table with a free-text transform box — not the drag-and-drop mapper with virtual fields and split modifiers (that richer tool is part of Manual CSV Import instead, see How to Import Leads from a CSV File).

Map the JSON fields a vendor sends into your webhook endpoint onto KamoCRM's system lead fields, so incoming payloads turn into leads.

Before you start

• The endpoint must already exist — see How to Create a Lead Intake Endpoint
• Your vendor needs to have sent at least one payload to the endpoint already. Sample fields are detected from real received payloads — there's nothing to map until the first one arrives.

Steps

1. Go to Settings → Client Relations Manager → Automated Imports.
2. Click Manage on the endpoint, then open the Field Mapping tab.
3. If no payload has been received yet, you'll see "Waiting for First Submission" — share the endpoint URL with your vendor and come back once they've sent test data.
4. Once sample fields are detected, click Add Mapping for each field you want to bring in:
   • Source Field (Vendor) — pick from the vendor's detected JSON fields.
   • System Field (Lead) — pick the KamoCRM lead field it should fill.
   • Transform — optional free-text box for a transformation (e.g. typing something like "trim, upper").
5. Check the Mapping Preview card — it shows your current mapping set as JSON, useful for a final sanity check.
6. Click Save Mapping.

What you'll see

The endpoint's status moves from Pending to Configured as soon as at least one mapping is saved. From then on, incoming payloads are converted into leads using this mapping — visible per-payload under the endpoint's Queue tab.