Building a webhook integration? Read the webhook guide for signatures, retries, event schemas, and troubleshooting.

apiDeterministic

List segments

GET /api/launchpad/segments

List the workspace GTM segments available in Launchpad so the operator can choose an exact segment before creating or reusing a campaign brief. Never guess when multiple segments are returned.

Parameters

workspaceIdrequired

string

No description.

includeArchived

boolean

No description.

Example

REST requestbash

curl -X GET "https://app.pipeline.help/api/launchpad/segments?workspaceId=00000000-0000-4000-8000-000000000000" \
  -H "Authorization: Bearer $PIPELINE_API_KEY"

Response

Success response schemajson schema

{
  "type": "object",
  "properties": {
    "segments": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "workspaceId": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "icon": {
            "type": [
              "string",
              "null"
            ]
          },
          "color": {
            "type": [
              "string",
              "null"
            ]
          },
          "valueProp": {
            "type": [
              "string",
              "null"
            ]
          },
          "pain": {
            "type": [
              "string",
              "null"
            ]
          },
          "criteria": {
            "type": "object"
          },
          "exampleAccounts": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "domain": {
                  "type": "string"
                }
              },
              "required": [
                "name"
              ]
            }
          },
          "personaIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "icpProfileId": {
            "type": [
              "string",
              "null"
            ]
          },
          "weight": {
            "type": "number"
          },
          "estimatedLeads": {
            "type": [
              "number",
              "null"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "draft",
              "active",
              "archived"
            ]
          },
          "briefId": {
            "type": [
              "string",
              "null"
            ]
          },
          "tableId": {
            "type": [
              "string",
              "null"
            ]
          },
          "campaignId": {
            "type": [
              "string",
              "null"
            ]
          },
          "generatedByAgentRunId": {
            "type": [
              "string",
              "null"
            ]
          },
          "createdBy": {
            "type": "string"
          },
          "createdAt": {
            "type": "string"
          },
          "updatedAt": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "workspaceId",
          "name",
          "slug",
          "icon",
          "color",
          "valueProp",
          "pain",
          "criteria",
          "exampleAccounts",
          "personaIds",
          "icpProfileId",
          "weight",
          "estimatedLeads",
          "status",
          "briefId",
          "tableId",
          "campaignId",
          "generatedByAgentRunId",
          "createdBy",
          "createdAt",
          "updatedAt"
        ]
      }
    }
  },
  "required": [
    "segments"
  ]
}

HTTP errors

401: Missing or invalid API key.
403: Authenticated but not permitted for the workspace or resource.
404: The requested resource was not found.