Explorar el catálogo de temas

GET /api/v1/signup-page-templates Los temas de páginas de suscripción que mantenemos, en el orden del catálogo. Toma el content de uno, envíalo como content de tu página y tendrás una página funcional sin escribir una línea de HTML. Solo lectura. No hay ningún endpoint para añadir, cambiar o eliminar un tema: el catálogo pertenece al producto, no a una organización, y es el mismo para todas las claves.

Autorización

Rol en la organizaciónEste endpoint
OWNERPermitido
ADMINPermitido
MEMBERPermitido
Una clave lleva el rol que su creador tiene en esta organización, nunca un rol en AgentsMail en sí. Consulta Claves de API.

Ejemplo

bash
curl -H "x-api-key: $AGENTMAIL_API_KEY" \
  "https://www.agentsmail.io/api/v1/signup-page-templates"

Respuesta

  • 200 OK: los temas publicados, en el orden del catálogo.
  • 401 Unauthorized: clave ausente o no válida, o su propietario dejó la organización.
  • 429 Too Many Requests: la clave superó su límite de peticiones.

Campos de la respuesta

CampoTipoDescripción
successbooleanIndica si la operación tuvo éxito
dataarrayLos temas
data[].idstringIdentificador único del tema
data[].namestringSu nombre: ponlo en sourceTemplateName cuando lo copies
data[].descriptionstring | nullUna línea sobre su aspecto
data[].contentstringEl HTML que copiar en tu página
data[].previewImageUrlstring | nullUna miniatura del tema, cuando la hay
data[].positionnumberOrden en el catálogo, de menor a mayor
data[].createdAtstringFecha de creación ISO
data[].updatedAtstringFecha ISO del último cambio

Ejemplo de respuesta

json
{
  "success": true,
  "data": [
    {
      "id": "2f2f2f2f-5555-4aaa-8bbb-999900001111",
      "name": "Minimal",
      "description": "One column, one form, nothing else",
      "content": "<html><body><h1>{{heroTitle}}</h1>{{form}}{{poweredBy}}</body></html>",
      "previewImageUrl": "https://www.agentsmail.io/thumbnails/minimal.png",
      "position": 1,
      "createdAt": "2026-07-01T09:00:00.000Z",
      "updatedAt": "2026-08-02T10:00:00.000Z"
    }
  ]
}

Notas

  • Aquí no hay paginación ni búsqueda. Todo el catálogo llega en una sola llamada: fíltralo por tu lado.
  • Lo que llega está publicado, siempre. Un tema que todavía se está preparando no está en esta lista, y nada en la respuesta indica que un tema pueda estar en otro estado.
  • Todos los temas llevan {{form}}, así que una copia se acepta tal cual. Si la editas, el resultado es tuyo: el marcador {{form}} tiene que sobrevivir a tus cambios.

Relacionado