Skip to main content
POST
/
api
/
network
/
connections
Import network connections
curl --request POST \
  --url https://app.puffle.ai/api/network/connections \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "connections": [
    {
      "firstName": "<string>",
      "lastName": "<string>",
      "email": "<string>",
      "company": "<string>",
      "position": "<string>",
      "connectedOn": "<string>",
      "linkedinUrl": "<string>"
    }
  ],
  "clearExisting": true
}
'
{ "message": "Connections imported successfully", "imported": 842, "skipped": 0, "total": 842 }

​
Overview

Bulk-upsert LinkedIn connections parsed from the caller’s LinkedIn data export. Uses (user_id, linkedin_url) as the conflict key. Optionally clears the caller’s existing connections first via clearExisting: true — irreversible, so prompt the user before calling.
This operation shares the URL path /api/network/connections with other verbs. See the sibling page for related operations on the same resource.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Bulk import payload. Intended to be posted directly from a parsed LinkedIn Connections.csv.

​
connections
object[]
required

Rows to upsert. Batched in groups of 500 server-side; batch-level failures are counted as skipped rather than aborting the import.

​
clearExisting
boolean

If true, delete every existing connection row for this user before inserting the new set. Destructive — the delete runs BEFORE the insert, so a partial failure leaves you with fewer connections than you started with.

Response

Import attempted. Per-batch failures roll into skipped rather than failing the whole request.

​
message
enum<string>
required
Available options:
Connections imported successfully
​
imported
integer
required
Required range: 0 <= x <= 9007199254740991
​
skipped
integer
required
Required range: 0 <= x <= 9007199254740991
​
total
integer
required
Required range: 0 <= x <= 9007199254740991