Signals / REST API
Add champion
Track a decision-maker as a champion (a tracked LinkedIn profile flagged for relationship monitoring, distinct from prospects/influencers). Requires a LinkedIn account connected to the workspace.
POST /api/championsDeterministic operationParameters
workspaceIdOptional · string- Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.
workspace_idRequired · string- Workspace UUID. Required by this route even under API key auth (value is overridden with the key's workspace, but the field must be present).
linkedin_account_idRequired · string- Connected LinkedIn account UUID used to resolve the profile.
linkedin_urlRequired · string- The champion's LinkedIn profile URL, e.g. https://www.linkedin.com/in/username.
nameRequired · string- Display name for the champion.
roleOptional · string- Defaults to other.founder · co-founder · ceo · cmo · vp_sales · gtm_lead · other
notesOptional · string- Optional free-text notes.
curl -X POST "https://app.pipeline.help/api/champions" \
-H "Authorization: Bearer $PIPELINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"workspace_id":"00000000-0000-4000-8000-000000000000","linkedin_account_id":"00000000-0000-4000-8000-000000000000","linkedin_url":"https://example.com","name":"example"}'Full input schema
{
"type": "object",
"properties": {
"workspaceId": {
"type": "string",
"minLength": 1,
"description": "Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client."
},
"workspace_id": {
"type": "string",
"description": "Workspace UUID. Required by this route even under API key auth (value is overridden with the key's workspace, but the field must be present)."
},
"linkedin_account_id": {
"type": "string",
"description": "Connected LinkedIn account UUID used to resolve the profile."
},
"linkedin_url": {
"type": "string",
"description": "The champion's LinkedIn profile URL, e.g. https://www.linkedin.com/in/username."
},
"name": {
"type": "string",
"description": "Display name for the champion."
},
"role": {
"type": "string",
"enum": [
"founder",
"co-founder",
"ceo",
"cmo",
"vp_sales",
"gtm_lead",
"other"
],
"description": "Defaults to other."
},
"notes": {
"type": "string",
"description": "Optional free-text notes."
}
},
"required": [
"workspace_id",
"linkedin_account_id",
"linkedin_url",
"name"
]
}