Create a List
Create a new contact list for use in campaigns.
HTTP Request​
POST /v2/accounts/<account_sid>/lists
Request Parameters​
| Parameter | Required | Description |
|---|---|---|
name | Yes | Unique list name within your account |
tag | No | Optional tag for categorization |
Response​
Returns the created list with its SID, creation timestamp, and contact count.
Add Contacts to List​
HTTP Request​
POST /v2/accounts/<account_sid>/lists/<list_sid>/contacts
Request Parameters​
| Parameter | Description |
|---|---|
contact_references | Array of contact SIDs to add (max 5,000 per request) |
Response​
Returns success/failure status for each contact.
Upload Contacts via CSV​
HTTP Request​
POST /v2/accounts/<account_sid>/contacts/csv-upload
Request Parameters​
| Parameter | Required | Description |
|---|---|---|
list_name | Yes | Target list name |
file_name | Yes | Local CSV file path |
type | No | "static" or "dynamic" |
Check Upload Status​
GET /v2/accounts/<account_sid>/csv-status/<upload_id>
Returns upload progress: in-progress or completed, with stats on duplicates, successes, and failures.