Ir a la documentación
API

Listar firmas

Todas las firmas del espacio de trabajo, o las de una sola dirección.

GET/signatures

Ejecuta la llamada real en tu espacio de trabajo.

GET /signatures

Todas las firmas del espacio de trabajo, o las de una sola dirección.

Ejemplo

Requiere settings:read. Una dirección guarda una lista de firmas con nombre. Sin address, la lista contiene todas las direcciones, ordenadas por dirección y luego de la más antigua a la más reciente. Con él, solo las firmas de esa dirección, o las de un catch-all escrito *@acme.com.

curl
curl "$OE/[email protected]" -H "$AUTH"
Respuesta
{  "object": "list",  "data": [    {      "object": "signature",      "id": "sig_2b7e9c41d0a54f3e8c6d1a90",      "address": "[email protected]",      "name": "Work",      "html": "<p>Ada Lovelace<br />Head of Research, Acme Ltd</p>",      "isDefault": true,      "isReplyDefault": false,      "createdAt": "2026-09-02T08:14:03.117Z",      "updatedAt": "2026-10-01T10:05:12.031Z"    },    {      "object": "signature",      "id": "sig_8f2c1a9b7d3e4f60a1b2c3d4",      "address": "[email protected]",      "name": "Short",      "html": "<p>Ada<br />Acme Ltd</p>",      "isDefault": false,      "isReplyDefault": true,      "createdAt": "2026-10-12T09:14:03.117Z",      "updatedAt": "2026-10-12T09:14:03.117Z"    }  ],  "hasMore": false,  "nextCursor": null}

isDefault marca la firma que lleva el correo nuevo de la dirección, e isReplyDefault la que llevan sus respuestas y reenvíos. Como mucho una firma de una dirección tiene cada uno, una misma firma puede tener los dos, y una dirección puede no tener ninguno.

La lista se pagina con limit y cursor, como todas las listas. Una dirección que solo tuvo la única firma de versiones anteriores la muestra como una firma llamada Signature, predeterminada para ambos casos.

Una clave o una app limitada a ciertas direcciones o dominios solo alcanza las firmas de las direcciones que tiene, y las de un catch-all solo cuando tiene el dominio entero.

Referencia