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ón | Este endpoint |
|---|---|
OWNER | Permitido |
ADMIN | Permitido |
MEMBER | Permitido |
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
| Campo | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si la operación tuvo éxito |
data | array | Los temas |
data[].id | string | Identificador único del tema |
data[].name | string | Su nombre: ponlo en sourceTemplateName cuando lo copies |
data[].description | string | null | Una línea sobre su aspecto |
data[].content | string | El HTML que copiar en tu página |
data[].previewImageUrl | string | null | Una miniatura del tema, cuando la hay |
data[].position | number | Orden en el catálogo, de menor a mayor |
data[].createdAt | string | Fecha de creación ISO |
data[].updatedAt | string | Fecha 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.