CRM ingest
Point a CRM workflow webhook straight at your Service. Map its payload once; no glue code needed.
1. Set a mapping on the Service
IngestMapping maps link fields to JSON paths in the CRM’s payload. externalUserId is required.
HubSpot example
curl -X POST https://api-rewards.efiqone.com/v1/Services/RS8f2c… \
-u $EFIQ_ACCOUNT_SID:$EFIQ_AUTH_TOKEN \
-H "Content-Type: application/json" \
-d '{"ingestMapping":{"externalUserId":"$.objectId","externalRef":"$.properties.deal_id"},"ingestResponseMode":"url_only"}'2. Send the CRM payload
POST /v1/Services/{ServiceSid}/Ingest
{ "objectId": "hs_1001", "properties": { "deal_id": "D-77" } }| IngestResponseMode | Response |
|---|---|
full | The full link object |
url_only | { "url": "https://rewards.efiqone.com/g/…" } |
crm_fields | Field names you choose with IngestResponseFields, for writing straight back to a CRM property |
Payloads that don’t contain the mapped id fail with 400 / 20004.