Skip to main content
POST
/
api
/
lists
/
import
Import Leads
curl --request POST \
  --url https://app.puffle.ai/api/lists/import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "leads": [
    {
      "name": {
        "full": "<string>",
        "short": "<string>",
        "aliases": [
          "<string>"
        ],
        "first": "<string>",
        "last": "<string>"
      },
      "title": "<string>",
      "company": {
        "name": "<string>",
        "id": "<string>",
        "domain": "<string>"
      },
      "location": {
        "city": "<string>",
        "state": "<string>",
        "country": "<string>",
        "raw": "<string>"
      },
      "socials": [
        {
          "url": "<string>"
        }
      ],
      "contacts": [
        {
          "value": "<string>"
        }
      ],
      "domain": "<string>",
      "industry": "<string>",
      "size": "<string>",
      "attributes": {},
      "sources": [
        {
          "id": "<string>"
        }
      ],
      "listIds": [
        "<string>"
      ],
      "raw": {}
    }
  ],
  "listId": "<string>",
  "preview": true
}
'
{
  "preview": {
    "leadCount": 4503599627370495,
    "personCount": 4503599627370495,
    "companyCount": 4503599627370495
  }
}
CLI:
puffle list import --leads <leads>
puffle list import --leads <leads> --list-id <list-id> --preview

Overview

Imports Leads into a List from structured input. Imported rows are normalized into Lead records and associated with the target List.

AI agent notes

Validate source data before import and keep the response identifiers for follow-up enrichment or campaign workflows. Use the duplicate-check endpoint when source overlap is likely.

Authorizations

Authorization
string
header
required

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

Body

application/json
leads
object[]
required
Required array length: 1 - 500 elements
listId
string
Minimum string length: 1
preview
boolean

Response

Import preview or synchronous import result.

preview
object
required