---
title: "Preview Activate Engagers"
method: POST
path: "/radar/competitors/{competitor_id}/engagers/activate/preview"
tags: ["Radar"]
---

# Preview Activate Engagers

`POST /radar/competitors/{competitor_id}/engagers/activate/preview`

## Request

- Base URL: `https://be.graph8.com/api/v1`
- URL: `https://be.graph8.com/api/v1/radar/competitors/{competitor_id}/engagers/activate/preview`
- Auth: HTTP bearer

Dry run of the activation: what would be added and why the rest would be skipped. WRITES NOTHING.

`will_add`, and `skipped` split into `suppressed` (sequence enrollment only), `already_member`, `conflicts`
(blocked by a rep limit), `warned` (409 on the real call; resubmit with `conflict_resolution`) and `not_engager`.
The access checks still fail (403 or 404) exactly as the real call does.

## Path parameters

- `competitor_id` string, required: Competitor id (from GET /radar/competitors).

## Headers

- `Authorization` string, nullable
- `X-Target-Org-Id` string, nullable

## Request body

- ActivateEngagersRequest
  - `contact_ids` integer[], required
  - `action` 'add_to_list' | 'enroll_sequence', required
  - `destination_list_id` integer, nullable
  - `destination_list_name` string, nullable
  - `sequence_id` string, nullable
  - `conflict_resolution` 'add_all' | 'skip_all' | 'custom', nullable
  - `include_warned_ids` string[], nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-19** `2e7cfa0ca921`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/graph8/apis/graph8-developer-api/changes/radar/competitors/:competitor_id/engagers/activate/preview/post.md)

---

[API](https://skmtc.dev/graph8/apis/graph8-developer-api.md) · [All operations](https://skmtc.dev/graph8/apis/graph8-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/graph8/apis/graph8-developer-api/revisions/2e7cfa0ca921?raw)