> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ryzeapi.cloud/llms.txt
> Use this file to discover all available pages before exploring further.
# Salir del newsletter
> Cancela la suscripción de la cuenta a un newsletter
**Auth:** `TokenAccount` o `TokenInstance` • **Rate-limit:** `Global` (100/min) • **Idempotente:** parcial (salir de un newsletter que no sigues puede devolver `not found`)
## Descripción
Cancela la suscripción (unfollow). Los mensajes futuros dejan de llegar y el newsletter desaparece de [`GET /list`](/es/api/newsletter/list). El identifier se pasa como **query string** (no en el body), ya que se trata de un `DELETE`.
## Ejemplos
### Por JID
Cancela la suscripción pasando el JID canónico del newsletter a través del query string. Los mensajes futuros dejan de llegar y el newsletter desaparece de `GET /list`.
```bash cURL theme={null}
curl -X DELETE "https://ryzeapi.cloud/api/newsletter/leave/$Instance_Name?identifier=120363422585881117@newsletter" \
-H "token: $Token_Instance"
```
```javascript JavaScript theme={null}
await fetch(`https://ryzeapi.cloud/api/newsletter/leave/${process.env.Instance_Name}?identifier=120363422585881117@newsletter`, {
method: "DELETE",
headers: {
"token": process.env.Token_Instance
}
});
```
```python Python theme={null}
import os, requests
requests.delete(
f"https://ryzeapi.cloud/api/newsletter/leave/{os.environ['Instance_Name']}",
params={"identifier": "120363422585881117@newsletter"},
headers={
"token": os.environ["Token_Instance"]
}
)
```
```go Go theme={null}
package main
import (
"net/http"
"os"
)
func main() {
req, _ := http.NewRequest("DELETE", "https://ryzeapi.cloud/api/newsletter/leave/"+os.Getenv("Instance_Name")+"?identifier=120363422585881117@newsletter", nil)
req.Header.Set("token", os.Getenv("Token_Instance"))
http.DefaultClient.Do(req)
}
```
### Por enlace
Cancela la suscripción pasando el enlace de invitación completo. El servidor extrae el código, resuelve el JID y ejecuta el unfollow.
```bash cURL theme={null}
curl -X DELETE -G "https://ryzeapi.cloud/api/newsletter/leave/$Instance_Name" \
--data-urlencode "identifier=https://whatsapp.com/channel/120363422585881117" \
-H "token: $Token_Instance"
```
```javascript JavaScript theme={null}
const params = new URLSearchParams({ identifier: "https://whatsapp.com/channel/120363422585881117" });
await fetch(`https://ryzeapi.cloud/api/newsletter/leave/${process.env.Instance_Name}?${params}`, {
method: "DELETE",
headers: {
"token": process.env.Token_Instance
}
});
```
```python Python theme={null}
import os, requests
requests.delete(
f"https://ryzeapi.cloud/api/newsletter/leave/{os.environ['Instance_Name']}",
params={"identifier": "https://whatsapp.com/channel/120363422585881117"},
headers={
"token": os.environ["Token_Instance"]
}
)
```
```go Go theme={null}
package main
import (
"net/http"
"net/url"
"os"
)
func main() {
q := url.Values{}
q.Set("identifier", "https://whatsapp.com/channel/120363422585881117")
req, _ := http.NewRequest("DELETE", "https://ryzeapi.cloud/api/newsletter/leave/"+os.Getenv("Instance_Name")+"?"+q.Encode(), nil)
req.Header.Set("token", os.Getenv("Token_Instance"))
http.DefaultClient.Do(req)
}
```
### Por código
Cancela la suscripción pasando solo el código de invitación. Igual que con el enlace, sin el prefijo del dominio.
```bash cURL theme={null}
curl -X DELETE "https://ryzeapi.cloud/api/newsletter/leave/$Instance_Name?identifier=120363422585881117" \
-H "token: $Token_Instance"
```
```javascript JavaScript theme={null}
await fetch(`https://ryzeapi.cloud/api/newsletter/leave/${process.env.Instance_Name}?identifier=120363422585881117`, {
method: "DELETE",
headers: {
"token": process.env.Token_Instance
}
});
```
```python Python theme={null}
import os, requests
requests.delete(
f"https://ryzeapi.cloud/api/newsletter/leave/{os.environ['Instance_Name']}",
params={"identifier": "120363422585881117"},
headers={
"token": os.environ["Token_Instance"]
}
)
```
```go Go theme={null}
package main
import (
"net/http"
"os"
)
func main() {
req, _ := http.NewRequest("DELETE", "https://ryzeapi.cloud/api/newsletter/leave/"+os.Getenv("Instance_Name")+"?identifier=120363422585881117", nil)
req.Header.Set("token", os.Getenv("Token_Instance"))
http.DefaultClient.Do(req)
}
```
## Respuesta exitosa
La respuesta devuelve el JID canónico del newsletter en `channelJid` (resuelto desde el `identifier` pasado en la query, incluso si fue un enlace o código). Después de este retorno, el newsletter se elimina de [`/list`](/es/api/newsletter/list) y los mensajes futuros dejan de llegar.
```json 200 OK theme={null}
{
"success": true,
"message": "Successfully left newsletter",
"channelJid": "120363422585881117@newsletter"
}
```
## Parámetros de ruta
Nombre de la instancia.
## Cabeceras
`TokenAccount` o `TokenInstance`.
## Query
JID `@newsletter`, enlace completo o código de invitación.
## Notas
* Si eres el **propietario / administrador** del newsletter, `leave` solo cancela tu suscripción, el newsletter sigue existiendo. Para eliminar el newsletter, usa la interfaz oficial de WhatsApp.
* `DELETE` sin body es la convención; un body JSON se ignora.
* No hay un evento dedicado de "unfollowed" en el webhook; los mensajes del newsletter simplemente dejan de llegar.
## Errores
| HTTP | Mensaje |
| ---- | ------------------------------------------------------------------------------------ |
| 400 | `The 'identifier' query parameter is required (JID @newsletter or invite link/code)` |
| 400 | `Invalid newsletter identifier (use JID @newsletter or invite link/code)` |
| 500 | `failed to leave newsletter: ` |
| 501 | `WhatsApp client does not support UnfollowNewsletter` |
Envoltorio:
```json theme={null}
{
"success": false,
"error": { "message": "Invalid newsletter identifier (use JID @newsletter or invite link/code)" }
}
```
## Siguiente
Confirma que el newsletter fue eliminado.
Suscríbete a otro newsletter.