Jobs

Queue async lead import

Queues an async import job for up to 1000 leads. Furnace allows at most 3 queued or running async jobs per account at a time. Per-row lead.created / lead.updated webhooks are suppressed during processing; a single lead.bulk_import.completed event is emitted when the job completes successfully.

POST/v1/campaigns/{id}/leads/bulk/async

Authorization

bearerAuth

AuthorizationBearer <token>

Use an account API key in the Authorization header: Authorization: Bearer f_....

In: header

Path Parameters

idstring

Campaign id.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

leadsarray<LeadCreate>

Items1 <= items <= 1000

curl -X POST "https://example.com/v1/campaigns/497f6eca-6276-4993-bfeb-53cbbbba6f08/leads/bulk/async" \  -H "Content-Type: application/json" \  -d '{    "leads": [      {        "email": "jane@example.com",        "first_name": "Jane",        "custom_lead_data": {          "company": "Acme Co",          "source": "Landing Page"        },        "tags": [          "Hunter"        ],        "email_verification": {          "status": "ok",          "provider": "millionverifier"        }      }    ]  }'

{  "data": {    "id": "6a8584eb-0ee5-4d7d-8eb6-db9259914e18",    "campaign_id": "1d8dc901-3d2d-4d9f-9dcc-4f8b3aa1a1fb",    "account_id": "04bc2b35-a282-4581-a53f-50435d8309f1",    "created_by_api_key_id": "a66d06b0-dfe0-420b-8c05-1e7301ad1514",    "status": "queued",    "input": {      "leads": [        {          "email": "jane@example.com"        }      ]    },    "result": {},    "errors": []  }}

{  "error": {    "type": "invalid_request_error",    "code": "invalid_flow",    "message": "Flow validation failed"  },  "details": [    {      "path": "nodes[1].data.variants[0].id",      "code": "invalid_variant_id",      "message": "Email variants must have a stable UUID id."    }  ]}

{  "error": {    "type": "authentication_error",    "code": "invalid_api_key",    "message": "A valid Furnace API key is required"  }}

{  "error": {    "type": "permission_error",    "code": "smartlead_read_only",    "message": "Smartlead campaigns are read-only via the API"  }}

{  "error": {    "type": "invalid_request_error",    "code": "campaign_not_found",    "message": "Campaign not found"  }}

{  "error": {    "type": "rate_limit_error",    "code": "rate_limit_exceeded",    "message": "Rate limit exceeded for this account"  }}

{  "error": {    "type": "api_error",    "code": "internal_error",    "message": "Internal server error"  }}