POST
/
lists
curl --request POST \
  --url https://api.pipeium.com/lists \
  --header 'Authorization: Bearer {api_key}' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Enterprise Prospects",
    "webhook_url": "https://api.yourapp.com/webhooks/pipeium"
  }'

{
  "message": "List created",
  "listId": "123e4567-e89b-12d3-a456-426614174000"
}
Create a new list to organize contacts and accounts. Lists are the primary way to group and manage your data in Pipeium.

​
Body Parameters

​
name
string
required
Name of the list
​
webhook_url
string
Optional webhook URL to receive notifications about list changes

​
Response

​
message
string
Success message
​
listId
string
ID of the created list
curl --request POST \
  --url https://api.pipeium.com/lists \
  --header 'Authorization: Bearer {api_key}' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Enterprise Prospects",
    "webhook_url": "https://api.yourapp.com/webhooks/pipeium"
  }'

{
  "message": "List created",
  "listId": "123e4567-e89b-12d3-a456-426614174000"
}