/subscriber/subscribe
Suscribe o actualiza los datos de un suscriptor.
| Parámetros | |||||
|---|---|---|---|---|---|
| Nombre | Descripción | ||||
| list_id string |
ID de la lista. | ||||
| email string |
Dirección de email del suscriptor. | ||||
| update boolean |
Indica si se debe actualizar los datos de un suscriptor existente o suscribir uno nuevo. Si ‘update’ es TRUE y la dirección de email no existe, se suscribirá. (opcional). | ||||
| name string |
Nombre del suscriptor. (Opcional). Si no se ingresa un nombre al actualizar los datos de un suscriptor, se mantendrá el nombre actual. | ||||
| custom_fields array |
Datos de los campos personalizados. Cada elemento del array, contiene un array con name y value. Todos los campos son opcionales. Si no se indican en la actualización, se mantienen los valores actuales. (opcional)
|
||||
| subscribed boolean |
Al suscribir un email, puede enviarle el email de confirmación para que se valide la dirección, o suscribirlo de forma directa. TRUE suscribirá de forma directa.(Opcional). | ||||
| Valores de retorno | |
|---|---|
| status | “success”. |
| Códigos de error | |
|---|---|
| S10001D | La dirección de email no es válida. |
| S10002D | La dirección de email se encuentra en Blacklist. |
| S10007D | La dirección de email no es válida. |
| S10006D | La dirección podrías ser falsa o prohibida. |
| S10003Q | Su cuenta no dispone de límite suficiente para agregar mas suscriptores. |
| S10004L | La lista no existe. |
| S10005E | El email no se encuentra en la lista especificada. |
Suscripción y cambio de estado
Si una dirección ya se encuentra en la lista en estado pendiente, podrá activarla utilizando los parámetros “update” y “subscribed” en TRUE.
Cuando actualiza los datos de un suscriptor, el nombre se actualizará únicamente si lo provee. De lo contrario, se mantendrá el actual.
En caso de los campos personalizados, solo se actualizará los datos de los campos que estén en el array, aun si su valor estuviera vacío. Todos los campos personalizados son opcionales. Los campos que no estén en el array, no se actualizarán.
Automatización
Cualquier automatización asociada a la suscripción en esta lista, será ejecutada.