Recibir correos: Contactos y público

Guardar segmento

Crea o actualiza un segmento de este buzón.

POSThttps://g.sendcorex.com/v1command: save_segment
i

Un segmento pertenece a un buzón. Para usarlo en otro buzón, guarda una copia allí.

i

Necesita el permiso de organizar (no disponible para tokens de solo lectura).

Argumentos

  • segment_idstringopcional

    Déjalo fuera para crear un segmento nuevo.

  • namestringobligatorio

    Hasta 200 caracteres.

  • whereobjectobligatorio

    El filtro. Mismo formato que list_contacts.

  • sortobjectopcional

    { field }: email, created_at, last_open_at, last_click_at, open_count o click_count.

Inicio rápido

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "save_segment",
        args: {
          name: "Opened in 30 days",
          where: {
            last_open_at: {
              within_days: 30
            }
          }
        }
      }
    ]
  },
  { headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);

const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);

Respuesta

{
  "type": "SUCCESS",
  "results": [
    {
      "command": "save_segment",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "segment": {
          "segment_id": "seg_8Hq2",
          "name": "Opened in 30 days",
          "where": {
            "last_open_at": {
              "within_days": 30
            }
          },
          "sort": null,
          "created_at": "2026-11-21T10:00:00Z",
          "updated_at": "2026-11-21T10:00:00Z"
        }
      }
    }
  ]
}

Campos de la respuesta

  • segment

    El segmento guardado.

Errores

Los errores a nivel HTTP devuelven type, code y message. Los errores marcados con CMD vuelven dentro del resultado del comando, con HTTP 200.

  • 401TOKEN_EXPIRED

    El access token expiró. Llama a Refresh Token y repite la solicitud.

  • 401INVALID_TOKEN

    El token está mal formado, es desconocido o fue revocado.

  • 429RATE_LIMITED

    Más de 15 solicitudes/s o 15 en curso para la misma IP + buzón. Espera la cantidad de segundos indicada en Retry-After.

  • CMDINVALID_ARGS

    Falta un argumento obligatorio o no es válido.

  • CMDNOT_FOUND

    El mensaje, la conversación o la carpeta no existe para este token.

  • CMDREAD_ONLY_ACCESS

    El token o la app tiene acceso de Solo lectura y el comando escribe. En la ruta de subida de adjuntos es HTTP 403.

  • CMDINTERNAL

    Error del servidor. El detalle solo se escribe en el log del servidor.