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" } }
IngestResponseModeResponse
fullThe full link object
url_only{ "url": "https://rewards.efiqone.com/g/…" }
crm_fieldsField 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.