Allows a new Lead List to be added to a Convoso account.
Endpoint:
POST https://api.convoso.com/v1/list/insert
đź”’ Authentication
- Parameter Name: auth_token
- Type: Query Parameter
- Required: Yes
🔎 Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| auth_token | string | Yes | API key for authentication. |
| name | string | Yes | Human-readable name for the list. Must be at least 10 characters long. |
| campaign_id | string | Yes | The campaign the list should be assigned to. |
| description | string | No | The description of the list. 0-255 Characters. |
| status | string | No | The status of the list. Default = 1 (Active) |
Example Request
POST https://api.convoso.com/v1/lists/insert?auth_token=your_auth_token&name=MyListName&campaign_id=2999&description=List Description&status=1
Response Format (JSON)
{
"success": true,
"data": {
"list_id": 2807
},
"id": 2807
}Response Field Definitions
Top-Level Data Object
| Field | Type | Description |
|---|---|---|
| success | boolean | Identifies if the API was executed successfully |
| data | object | Response Object |
| id | integer | list identifier assigned to the newly created list |
Data Object
| Field | Type | Description |
|---|---|---|
| list_id | integer | List identifier assigned to the newly created list |