Upsert Lists (bulk)

PUT

/lists/bulk

Create or update multiple lists at once.

Limit: maximum 100 lists per request.

For each item, provide exactly one of categoryId or categoryName.

Request

Header Params

Body Params application/json

Examples

Responses

🟢207

application/json

Description
Returned when the request contains a mix of successes and failures.

Bodyapplication/json

🟠400

🟠413

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT '/lists/bulk' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "lists": [
        {
            "name": "Customers",
            "description": "Customers list",
            "order": 10,
            "categoryName": "Marketing"
        },
        {
            "name": "Leads",
            "description": "Leads list",
            "order": 20,
            "categoryId": 2
        }
    ]
}'

Response Example

207 - Success

{
    "results": [
        {
            "index": 0,
            "status": 201,
            "operation": "created",
            "list": {
                "id": 10,
                "name": "Customers",
                "description": "Customers list",
                "category": {
                    "id": 1,
                    "name": "Marketing"
                }
            }
        },
        {
            "index": 1,
            "status": 200,
            "operation": "updated",
            "list": {
                "id": 11,
                "name": "Leads",
                "description": "Leads list",
                "category": {
                    "id": 2,
                    "name": "Sales"
                }
            }
        }
    ]
}

Modified at 2026-06-11 02:37:32

Get contact counts for all lists (grouped by category)

Get List categories