Skip to main content
POST
/
v1
/
social
/
ingest
Ingest Social Signals
curl --request POST \
  --url https://www.signalark.app/_api/v1/social/ingest \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "events": [
    {
      "platform": "<string>",
      "engagement_type": "<string>",
      "engager_name": "<string>",
      "engager_profile_url": "<string>",
      "engager_company": "<string>",
      "company_domain": "<string>",
      "post_url": "<string>",
      "warmth_hint": 123
    }
  ]
}
'
{
  "success": true,
  "batchId": "<string>",
  "promotedToPipeline": 123
}
Use this endpoint to push social engagement data (likes, comments, mentions) into the dedicated Social Engagement pipeline. High-warmth, ICP-qualified leads from this pipeline are automatically promoted to standard Sales Deals/Accounts.

​
Request Body

Provide an array of ExternalSocialSignal objects under the events key. Required Fields per Event:
  • platform (string: e.g., linkedin, twitter, hackernews)
  • engagement_type (string: e.g., like, comment, repost)
Recommended Fields:
  • engager_profile_url - Crucial for contact resolution.
  • company_domain - Crucial for account matching.
  • warmth_hint (integer 0-100) - Overrides the baseline warmth score for this engagement type.
Optional Fields:
  • engager_name, engager_title, engager_company
  • engagement_content, post_content, post_url
  • engagement_date

​
Response

Authorizations

​
Authorization
string
header
required

Use format Bearer sak_your_api_key_here

Body

application/json
​
events
object[]
required

Response

200 - application/json

Social ingestion successful

​
success
boolean
​
batchId
string
​
promotedToPipeline
integer