Create source

Creates a new source (or upserts when the same sourceType + sourceIdentifier already exists).

Body shape depends on sourceType. For LinkedIn social listening, use the examples below.

Profile / page listening (linkedinInbound, linkedinOutbound): pass sourceIdentifier as a LinkedIn
person (/in/) or company/page (/company/, /showcase/, /school/) URL.

Post listening (linkedinPost): pass a LinkedIn post or activity URL as sourceIdentifier.

Keyword search (linkedinKeywordSearch): omit sourceIdentifier; put search options in sourceMeta
(keyword required, min 3 chars; optional postedTime, authorTitle, sourceName).

Job posting (linkedinJobPosting): omit sourceIdentifier; put job search options in sourceMeta
(jobTitle, jobLocation, postedTime, jobType, optional sourceName / field mapping).

Webhook import (importFromWebhook): create a source that you can push selected rows into (for example after POST /discovery-search/find-verified-contacts). Find does not auto-save to a segment.

Put column mapping on the source, not on bulk upsert:

sourceMeta.config.fieldMapping — each { sourceFieldName, hpFieldName } maps a key in contactsData to a Highperformr field from GET /schema/contact (writeAccessPath, e.g. contact.linkedIn).

Optional segmentId (top-level) attaches this source to an existing segment. You can also pass segmentId on bulk upsert.

Then upsert rows with POST /contacts/{sourceId}/bulk-upsert-contacts (bulk upsert contacts). Do not send fieldMapping on that call.

curl --location 'https://app.highperformr.ai/api/sources' \ --header 'x-api-key: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "sourceType": "linkedinInbound", "sourceIdentifier": "https://www.linkedin.com/in/jamie-rivera-example" }'

{ "data": { "id": "src_li_inbound_01", "type": "sources", "attributes": { "sourceType": "linkedinInbound", "sourceIdentifier": "https://www.linkedin.com/in/jamie-rivera-example", "sourceMeta": { "socialName": "Jamie Rivera", "socialHandle": "jamie-rivera-example", "platformName": "linkedin", "interactionType": "inbound", "profileImageUrl": "https://media.licdn.com/example.jpg" }, "refreshStatus": null, "createdAt": "2025-04-08T09:01:44.000Z" } } }

Request

Responses