Batch Ingest Social Engagement Events into Signal Ark

Use POST /v1/social/ingest to push social engagement events into Signal Ark’s dedicated social pipeline. When someone interacts with your content on LinkedIn, X (Twitter), Hacker News, or any other platform, you can send that engagement to Signal Ark. Events are warmth-scored, ICP-qualified, and — when they cross the threshold — automatically promoted to your sales pipeline as live deals or accounts. Endpoint: POST https://www.signalark.app/_api/v1/social/ingest Authentication: Authorization: Bearer sak_your_api_key_here

Request body

events

object[]

required

Array of social engagement event objects to ingest.

Show Event object fields

platform

string

required

The social platform where the engagement occurred. Common values include linkedin, twitter, and hackernews, but any platform identifier is accepted.

engagement_type

string

required

The type of engagement. Common values include like, comment, repost, and mention. Signal Ark uses engagement type to assign a baseline warmth score, which you can override with warmth_hint.

engager_name

string

Full name of the person who engaged with the content. Used for contact resolution.

engager_profile_url

string

Profile URL of the engager (for example, a LinkedIn profile URL). This is the most reliable field for contact resolution — providing it significantly improves Signal Ark’s ability to identify and enrich the engager’s record.

engager_company

string

The engager’s company name as displayed on their social profile. Used as a fallback for account matching when company_domain is not available.

company_domain

string

The root domain of the engager’s employer (for example, acmecorp.com). Providing this is the most reliable way to match the engagement to an existing account.

post_url

string

URL of the post or content that was engaged with. Displayed in the Signal Ark UI for context and useful for grouping engagement events around a specific piece of content.

warmth_hint

integer

An optional warmth score override for this specific engagement event, from 0 (cold) to 100 (very warm). When provided, this value replaces Signal Ark’s baseline warmth score for the given engagement_type. Use this when your data source has its own quality or intent signals that are more accurate than Signal Ark’s defaults.

Example request

curl -X POST https://www.signalark.app/_api/v1/social/ingest \
  -H "Authorization: Bearer sak_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [
      {
        "platform": "linkedin",
        "engagement_type": "comment",
        "engager_name": "Jordan Lee",
        "engager_profile_url": "https://www.linkedin.com/in/jordan-lee-123",
        "engager_company": "Acme Corp",
        "company_domain": "acmecorp.com",
        "post_url": "https://www.linkedin.com/posts/yourcompany_post-id",
        "warmth_hint": 72
      },
      {
        "platform": "twitter",
        "engagement_type": "repost",
        "engager_name": "Alex Kim",
        "engager_profile_url": "https://x.com/alexkim",
        "company_domain": "brightsystems.io",
        "post_url": "https://x.com/yourcompany/status/123456789"
      }
    ]
  }'

Response

success

boolean

true when the batch was received and processed without a server error.

batchId

string

A unique identifier for this ingestion batch. Use this ID to correlate with webhook delivery events or when troubleshooting with Signal Ark support.

promotedToPipeline

integer

The number of events in this batch that, after warmth scoring and ICP qualification, were immediately promoted to your active sales pipeline as leads or accounts. Engagements that did not meet the threshold remain in the social pipeline for continued monitoring.

Example response

{
  "success": true,
  "batchId": "batch_01HZ9FGHIJ",
  "promotedToPipeline": 1
}

How warmth scoring works

Each engagement_type has a baseline warmth score. Signal Ark uses this score alongside ICP match data to decide whether an engager is worth promoting to the pipeline.

Engagement type	Baseline warmth
`mention`	80
`comment`	65
`repost`	50
`like`	30

Use warmth_hint to override these baselines when your data source has richer intent signals. For example, if you know a comment was a direct buying question, set warmth_hint: 90 to reflect that intent.

Provide engager_profile_url on every event. It is the single most impactful field for contact resolution. Without it, Signal Ark may not be able to associate the engager with an existing contact or company record.

Events that are not promoted immediately are not discarded. Signal Ark continues to track social engagement for each account and may promote contacts later as their cumulative warmth score increases across multiple interactions.

API Reference

Documentation Index

​Request body

​Example request

​Response

​Example response

​How warmth scoring works

Request body

Example request

Response

Example response

How warmth scoring works