Newsman – Knowledge Base
Newsman Api Method: transactional.emailAddRejectStatusType
Prototype: transactional.emailAddRejectStatusType(list_id, email, account_id)
Description: Adds a reject status type for an email. A message will be rejected if an email has a count of at least 1 for the status types spam, unsub, hardbounce. It will also be rejected if the status bounce (softbounce eg: out of storage space) exceeds 10. The response is an int with the new value of the status.
HTTP method: POST
Endpoint HTTP: /transactional.emailAddRejectStatusType.json
Endpoint XML-RPC: transactional.emailAddRejectStatusType
Return type: arrayReturn info: INT containing the new reject status value
Request parameters POST
| Variable | Type | Description |
|---|---|---|
| list_id | int|string | The ID of the list from which to identify the SMTP account |
| string | The email for which to add the reject status | |
| account_id | string|boolean | The id of a specific SMTP ACCOUNT in which to add the email reject status (optional). |
Response parameters
| Parameter | Description |
|---|---|
| struct | int containing the new value of the status |
Output example
1Response Errors
| Code | Message | Description |
|---|---|---|
| 407 | Missing required param list_id | list_id param is required |
| 101 | Not allowed for list_id = %s | Invalid access to list_id |
| 17003 | Could not find the SMTP account | Transactional account not found |
| 17004 | The SMTP account is inactive | The transactional account is inactive |
| 17019 | The email reject status could not be added: [error_reason] | The email reject status could not be added |
| 17020 | Invalid reject type | The reject status is invalid |
Error examples
{ "err": true, "message": "Missing required param list_id", "code": 407 }
{ "err": true, "message": "Could not find the SMTP account", "code": 17003 }
{ "err": true, "message": "The SMTP account is inactive", "code": 17004 }
{ "err": true, "message": "Invalid reject type", "code": 17020 }
{ "err": true, "message": "The email reject status could not be added: [error_reason]", "code": 17019 }