Install the Up2Data skill

Teach Claude Code to integrate the Up2Data API. Installs once, then loads automatically whenever you ask it about Up2Data.

  1. Run this in your terminal
    bash
    mkdir -p ~/.claude/skills/up2data-api && curl -fsSL https://up2data.ai/docs/legacy/skill.md -o ~/.claude/skills/up2data-api/SKILL.md
  2. Restart Claude CodeSo it picks up the new skill.
  3. Try it"Enrich these LinkedIn profiles with Up2Data and send results to my webhook"

Requires Claude Code. macOS, Linux, or WSL.

Prefer to read it first? View the skill file

Enqueue activity

Enqueue LinkedIn profiles for activity enrichment.

POSThttps://api.up2data.ai/api/open-refresh/activity
4 creditsasynchronous

Enqueue LinkedIn profiles for activity enrichment: the posts they published, the comments they left and the posts they reacted to. Send the same profile URLs or LinkedIn slugs you would send to profiles-bulk, and get back one Activity record per profile.

Asking for posts, comments and reactions separately through profiles-posts, profiles-comments and profiles-reactions costs more in total than one activity call - see the credit pills.

Warning

Ensure you have sufficient credits before making requests - see the credit pill above.

Info

Your profiles array is normalized and de-duplicated before anything is charged, so you pay for enqueued, not for what you sent. skipped reports what was removed and why. If nothing survives filtering, you get a 400 and no queue is created.

Info

An activity queue's results belong to the queue itself. Read them back with queues-list or wait for the webhook callback, and see Activity for the shape.

Info

partial tells you which of the three lists the last scrape could not read. A list flagged true was not refreshed: queues-list returns the values from the most recent successful scrape of that list, while the webhook callback carries it empty. scrapedAt always describes the latest scrape, so it can be newer than the contents of a flagged list. Check the flags before reading an empty list as "this person has none".

#Request

FieldTypeNotes
profilesrequiredstring[]LinkedIn profile URLs or bare slugs.
namestringOptional.
prioritynumberOptional, 1 = High, 2 = Normal, 3 = Low, defaults to 2.
webhookTagsstring[]Optional, defaults to every webhook on the team. Send [] to switch callbacks off - see the Webhooks guide.

#Call it

cURL
curl -X POST "https://api.up2data.ai/api/open-refresh/activity" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Q1 Leads Activity",
  "profiles": [
    "https://www.linkedin.com/in/johndoe",
    "https://www.linkedin.com/in/janedoe",
    "johndoe123"
  ],
  "priority": 2
}'

#Response

200 - Success
{
  "message": "3 activity items have been enqueued (12 credits).",
  "queueId": "507f1f77bcf86cd799439011",
  "enqueued": 3,
  "skipped": {
    "invalid": 0,
    "duplicates": 0
  },
  "webhooks": [
    {
      "_id": "6512c1a4f1b2c3d4e5f60789",
      "name": "Production",
      "url": "https://api.example.com/hooks/up2data"
    }
  ]
}
400 - Error
{
  "message": "No valid profiles to enqueue: of 4 submitted, 1 were invalid and 3 were duplicates."
}

#Webhook payload

Callback item
{
  "queueId": "507f1f77bcf86cd799439011",
  "name": "Q1 Leads Activity",
  "url": "https://www.linkedin.com/in/johndoe",
  "type": "Activity",
  "status": 200,
  "_id": "8f14e45fceea167a5a36dedd4bea2544",
  "result": { ... }
}

#Errors

StatusTypeWhen
400No valid profiles to enqueueEvery entry in profiles was invalid or a duplicate after normalization, so no queue was created.
400No webhook matches webhookTagsOne or more webhookTags do not match any webhook on the team.

See the Errors guide for every error type this version can return.