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

apiDeterministic

Add champion

POST /api/champions

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.

Parameters

workspaceId

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.

role

string

Defaults to other.

notes

string

Optional free-text notes.

Example

REST requestbash

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"}'

Response

The operation is available, but its typed response schema has not been published yet.

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.