36 lines
1.3 KiB
Markdown
36 lines
1.3 KiB
Markdown
[back to list](../Readme.md)
|
||
|
||
# Add Subscriber
|
||
|
||
## `array addList(array $list)`
|
||
|
||
In MailPoet, subscribers are organized into lists. This method provides functionality for creating a new list.
|
||
|
||
It returns the new list. See [Get Lists](GetLists.md) for a list data structure description.
|
||
|
||
## Arguments
|
||
|
||
### `$list` (required)
|
||
|
||
An associative array which contains list data.
|
||
|
||
| Property | Type | Limits | Description |
|
||
| ---------------------- | ------------ | --------- | -------------------------- |
|
||
| name (required) | string | 90 chars | A name of the list. |
|
||
| description (optional) | string\|null | 250 chars | A description of the list. |
|
||
|
||
## Error handling
|
||
|
||
All expected errors from the API are exceptions of class `\MailPoet\API\MP\v1\APIException`.
|
||
Code of the exception is populated to distinguish between different errors.
|
||
|
||
An exception of base class `\Exception` can be thrown when something unexpected happens.
|
||
|
||
Codes description:
|
||
|
||
| Code | Description |
|
||
| ---- | -------------------------------------------- |
|
||
| 14 | Missing list name |
|
||
| 15 | Trying to create a list that already exists |
|
||
| 16 | The list couldn’t be created in the database |
|