Ingest a journey completion

Creates a personalized presentation from a Demand IQ journey completion event. Pass the prospect identifier and the upstream event ID; Sales CoPilot fetches the authoritative homeowner, pricing, and product data from the Core API and provisions a presentation against the specified deck.

Authentication: accepts either a session cookie (browser/portal integrations) or a Bearer JWT (server-to-server integrations). Server-to-server callers are treated as trusted system principals and may ingest into any deck by UUID; session-authenticated callers can only ingest into decks owned by their organization.

Idempotency: a duplicate source_event_id for the same deck returns the existing presentation_id without creating a new presentation or sending any email.

Delivery: if delivery is enabled on the deck, the presentation link is emailed to the homeowner automatically. The send_status field reports the outcome.

POST /api/decks/{deckId}/ingest

Ingest a journey completion

cURL

curl --request POST \
  --url https://app.demand-iq.com/api/decks/{deckId}/ingest \
  --header 'Content-Type: application/json' \
  --cookie session= \
  --data '
{
  "prospect_id": "prospect_8c2f4e1a",
  "source_event_id": "evt_01HXYZ2K9M"
}
'

200

{
  "presentation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "presentation_url": "<string>"
}

Authorizations

sessionCookiebearerAuth

session · string · cookie · required

Session cookie obtained from POST /api/auth/login.

Path Parameters

deckId · string<uuid> · required

UUID of the deck to create the presentation from

Body

application/json

prospect_id · string · required

Identifier of the prospect in the Core API.

Example:

"prospect_8c2f4e1a"

source_event_id · string · required

Identifier of the upstream journey completion event. Used as the idempotency key for (deck_id, source_event_id).

Example:

"evt_01HXYZ2K9M"

Response

200

application/json

Presentation created or existing presentation returned for a duplicate event.

presentation_id · string<uuid>

ID of the created (or existing) presentation.

presentation_url · string<uri>

Shareable URL to the homeowner-facing presentation.

send_status · enum<string>

Outcome of the automatic email delivery. not_requested is returned for idempotent replays; skipped is returned when delivery is disabled on the deck.

Available options: sent, skipped, failed, not_requested