Skip to main content

Deal IDs

A Deal ID is a targeting handle that maps a Classify contextual segment to a specific DSP. It's the string you paste into your DSP's deal targeting field to buy against Classify-curated inventory.

How Deal IDs are created​

Deal IDs are created through the Segment Activation API. The flow:

  1. Build a segment via the Segment Creation API and wait for status: "complete"
  2. Call POST /v1/clsfy/activations with the segment ID, target DSP, and your buyer seat
  3. Classify pushes the segment into the DSP's supply chain
  4. Once activation completes, the response includes a deal_id you can target in your DSP
curl -X POST "https://api.clsfy.me/v1/clsfy/activations" \
  -H "X-API-Key: <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "segment_ids": [61],
    "dsp": "The Trade Desk",
    "buyer_seat": "seat-abc123"
  }'

The response returns the Deal ID once processing is complete:

{
  "deal_id": "classify-ttd-61-a8f3c"
}

Propagation time​

How quickly a Deal ID becomes targetable depends on whether the segment has been pushed to the target SSP before:

  • Previously activated SSP — the Deal ID is typically ready within a few hours
  • New SSP connection — propagation can take up to 2 days as the segment is established in the SSP's inventory for the first time

Poll GET /v1/clsfy/activations/{id} until status is "complete" to know when the Deal ID is ready.

Lifecycle​

Once active, a Deal ID stays live indefinitely as long as it is in use. There is no fixed expiration window.

However, there are two scenarios where a Deal ID can become inactive:

ScenarioWhat happens
InactivityIf a Deal ID goes unused for more than ~2 weeks, the SSP may automatically shut it down to free up inventory resources.
End date setIf you set an end_date when activating, Classify respects that date and the deal stops serving when it passes.

Re-activation​

If a Deal ID expires — either from inactivity or an end_date — you can re-activate it by calling the Activation API again with the same segment:

curl -X POST "https://api.clsfy.me/v1/clsfy/activations" \
  -H "X-API-Key: <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "segment_ids": [61],
    "dsp": "The Trade Desk",
    "buyer_seat": "seat-abc123"
  }'

This creates a new Deal ID for the same segment. The underlying segment does not need to be rebuilt — it still exists and is ready for activation.

Next steps​

  • Segment Activation API — full endpoint reference for creating and managing activations
  • DSP Deal ID Guides — platform-specific instructions for targeting Deal IDs in The Trade Desk, PubMatic, DV360, and Amazon DSP