This will allow you to subscribe a lead to any specific mailing list. Note that you must have previously created your list within your Kartra account (https://app.kartra.com/communication/lists). The API call will fail if it doesn’t find the specified list within your Kartra account.  

TypeParametersValues
POSTcmd*subscribe_lead_to_list
POSTlist_name*string

* Required fields Here is an example:

'lead' => [
    'email' => '[email protected]'
],
'actions' => [
    '0' => [
        'cmd' => 'subscribe_lead_to_list',
        'list_name' => 'List name'
    ]
]

Success message:

{
  "status": "Success",
  "message": "Lead subscribed to list",
  "type": "101"
}
Error Cases:
Type NumberMessageCause
207List cannot be empty
  • 'list_name' parameter it is mandatory and cannot be empty.
231List does not exist
  • The list is not in our database.
An example of an error message:
{
  "status": "Error",
  "message": "List cannot be empty",
  "type": "207"
}