ICP / GTM / REST API

Activate segment pilot

Activate one explicitly selected Launchpad segment. Deterministically creates or repairs its campaign brief, ICP profile, draft campaign, and Agent Teams table, then sources up to 10 pilot rows through the segment's connected provider and stops at a review approval. Does not scale, research, write copy, or launch the campaign.

POST /api/launchpad/activate-segmentDeterministic operation

Parameters

workspaceIdRequired · string: See the input schema for this field.
segmentIdRequired · string: Exact segment ID returned by list-segments. Never infer or auto-select it.
targetLeadCountOptional · number: Planned total audience after pilot approval. The initial pilot remains capped at 10 rows.

Request example

curl -X POST "https://app.pipeline.help/api/launchpad/activate-segment" \
  -H "Authorization: Bearer $PIPELINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"workspaceId":"00000000-0000-4000-8000-000000000000","segmentId":"00000000-0000-4000-8000-000000000000"}'

Full input schema

Input schema

{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string"
    },
    "segmentId": {
      "type": "string",
      "description": "Exact segment ID returned by list-segments. Never infer or auto-select it."
    },
    "targetLeadCount": {
      "type": "number",
      "description": "Planned total audience after pilot approval. The initial pilot remains capped at 10 rows."
    }
  },
  "required": [
    "workspaceId",
    "segmentId"
  ]
}

See this operation inCLI MCP TypeScript SDK