Rocketlead
  1. Lead Lists
Rocketlead
  • Accounts
    • List WA accounts
      GET
    • Get account by ID
      GET
    • Get account activity
      GET
    • Register phone on WhatsApp
      POST
    • Connect WA account
      POST
    • Setup account profile
      POST
    • Toggle account pause state
      POST
    • Update account phase
      PATCH
    • Set account display name
      POST
    • Set account avatar
      POST
  • Campaigns
    • List campaigns
      GET
    • Create campaign
      POST
    • Get campaign by ID
      GET
    • Update campaign
      PATCH
    • Delete campaign
      DELETE
    • Add step to campaign
      POST
    • Update campaign step
      PATCH
    • Delete campaign step
      DELETE
    • Reorder campaign steps
      PUT
    • Upload campaign media
      POST
    • Send test message for a campaign step
      POST
    • Start campaign
      POST
    • Pause campaign
      POST
    • Add leads to campaign
      POST
    • List campaign leads
      GET
    • Bulk lead action
      POST
    • Import leads into campaign
      POST
    • Get campaign daily stats
      GET
    • Duplicate campaign
      POST
    • Archive campaign
      POST
  • Leads
    • List all leads
    • List all lead tags
    • Update a lead
    • Bulk delete leads
    • List custom field definitions
    • Create custom field definition
  • Lead Lists
    • List lead lists
      GET
    • Create lead list
      POST
    • Get lead list by ID
      GET
    • Delete lead list
      DELETE
    • List leads in a list
      GET
    • Add lead to list
      POST
    • Bulk import leads to list
      POST
  • Conversations
    • List conversations
    • Get conversation messages
    • Send message in conversation
    • Update conversation tags
    • Toggle conversation read status
    • Schedule a message
    • List scheduled messages
    • Cancel scheduled message
    • List conversation tags
    • Create conversation tag
    • Delete conversation tag
    • Bulk conversation action
    • Get contact by phone
    • Update contact
    • Send test message
  • Agents
    • List agents
    • Create agent
    • Get agent usage stats
    • Get agent by ID
    • Update agent
    • Delete agent
    • Test agent with a message
    • Get competitor analysis
    • Run competitor analysis
  • Warmup
    • Get warmup status
    • Pause warmup for account
    • Resume warmup for account
  • Credits
    • Get current credit balance
    • List credit transactions
  • Orders
    • Create a new order
    • List orders
    • Get order details
  • Provision
    • Start provisioning by requesting OTP
    • Verify OTP and complete provisioning
  • Settings
    • Get workspace settings
    • Update workspace settings
  • Knowledge Base
    • List knowledge base sources
    • Create knowledge base source
    • Discover links from URL
    • Delete knowledge base source
    • Re-ingest knowledge base source
    • Get source chunks
    • Get knowledge base stats
  1. Lead Lists

Bulk import leads to list

POST
/api/v1/lead-lists/{id}/leads/bulk
Import up to 10,000 leads into a lead list in a single request. Each lead requires at minimum a phone number.

Request

Authorization
Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK
Default Response
This response does not have a body.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1/lead-lists//leads/bulk' \
--header 'Content-Type: application/json' \
--data-raw '{
    "leads": [
        {
            "phone": "string",
            "firstName": "string",
            "lastName": "string",
            "company": "string",
            "email": "string",
            "tags": [
                "string"
            ],
            "notes": "string",
            "customFields": {
                "property1": "string",
                "property2": "string"
            }
        }
    ]
}'
Modified at 2026-03-09 12:24:48
Previous
Add lead to list
Next
List conversations
Built with