SendGrid
Envía correos y gestiona contactos, listas y plantillas con SendGrid
Configuración
Enviar correo
Operación
Enviar correo
Clave de API de SendGrid*
••••••••
Correo del remitente*
sender@yourdomain.com
Nombre del remitente
Nombre del remitente
Correo del destinatario*
recipient@example.com
Nombre del destinatario
Nombre del destinatario
Asunto
Asunto del correo (obligatorio si no usas plantilla)
Contenido
Cuerpo del correo (obligatorio si no usas plantilla)
Tipo de contenido
Texto plano
CC
cc@example.com
CCO
bcc@example.com
Responder a
replyto@example.com
Nombre para responder
Nombre para responder
ID de plantilla
ID de plantilla de SendGrid
Datos dinámicos de plantilla
json
{"name": "John", "order_id": "12345"}
Archivos adjuntos
Sube archivos para adjuntar
Archivos adjuntos
Referencia archivos de bloques anteriores
Enviar correo (
sendgrid_send_mail)Envía un correo electrónico mediante la API de SendGrid
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave de API de SendGrid |
from | string | Sí | Dirección de correo del remitente (debe estar verificada en SendGrid) |
fromName | string | No | Nombre del remitente |
to | string | Sí | Dirección de correo del destinatario |
toName | string | No | Nombre del destinatario |
subject | string | No | Asunto del correo (obligatorio a menos que se use una plantilla con asunto predefinido) |
content | string | No | Cuerpo del correo (obligatorio a menos que se use una plantilla con contenido predefinido) |
contentType | string | No | Tipo de contenido (text/plain o text/html) |
cc | string | No | Dirección de correo CC |
bcc | string | No | Dirección de correo CCO |
replyTo | string | No | Dirección de correo de respuesta |
replyToName | string | No | Nombre de respuesta |
attachments | file[] | No | Archivos para adjuntar al correo |
templateId | string | No | ID de plantilla de SendGrid que se usará |
dynamicTemplateData | json | No | Objeto JSON con datos dinámicos de la plantilla |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Si el correo se envió correctamente |
messageId | string | ID de mensaje de SendGrid |
to | string | Dirección de correo del destinatario |
subject | string | Asunto del correo |
Añadir contacto
Operación
Añadir contacto
Clave de API de SendGrid*
••••••••
Correo electrónico*
contact@example.com
Nombre
John
Apellido
Doe
Campos personalizados
json
{"custom_field_1": "value1"}
IDs de lista
IDs de lista separados por comas
Añadir contacto (
sendgrid_add_contact)Añade un contacto nuevo a SendGrid
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave de API de SendGrid |
email | string | Sí | Dirección de correo del contacto |
firstName | string | No | Nombre del contacto |
lastName | string | No | Apellido del contacto |
customFields | json | No | Objeto JSON de pares clave-valor de campos personalizados (usa IDs de campo como e1_T, e2_N, e3_D, no nombres de campo) |
listIds | string | No | IDs de lista separados por comas a los que añadir el contacto |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
jobId | string | ID del trabajo para el seguimiento de la creación asíncrona del contacto |
email | string | Dirección de correo electrónico del contacto |
firstName | string | Nombre del contacto |
lastName | string | Apellido del contacto |
message | string | Mensaje de estado |
Obtener contacto
Operación
Obtener contacto
Clave de API de SendGrid*
••••••••
ID de contacto*
ID de contacto
Obtener contacto (
sendgrid_get_contact)Obtener un contacto específico por ID desde SendGrid
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave de API de SendGrid |
contactId | string | Sí | ID de contacto |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id | string | ID de contacto |
email | string | Dirección de correo del contacto |
firstName | string | Nombre del contacto |
lastName | string | Apellido del contacto |
createdAt | string | Marca de tiempo de creación |
updatedAt | string | Marca de tiempo de última actualización |
listIds | json | Array de ID de listas a las que pertenece el contacto |
customFields | json | Valores de campos personalizados |
Buscar contactos
Operación
Buscar contactos
Clave de API de SendGrid*
••••••••
Consulta de búsqueda*
email LIKE '%example.com%'
Buscar contactos (
sendgrid_search_contacts)Buscar contactos en SendGrid mediante una consulta
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave de API de SendGrid |
query | string | Sí | Consulta de búsqueda (p. ej., "email LIKE '%example.com%' AND CONTAINS(list_ids, 'list-id')") |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
contacts | json | Array de contactos coincidentes |
contactCount | number | Número total de contactos encontrados |
Eliminar contactos
Operación
Eliminar contactos
Clave de API de SendGrid*
••••••••
IDs de contacto*
IDs de contacto separados por comas
Eliminar contactos (
sendgrid_delete_contacts)Elimina uno o más contactos de SendGrid
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave de API de SendGrid |
contactIds | string | Sí | IDs de contactos separados por comas para eliminar |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
jobId | string | ID de trabajo de la solicitud de eliminación |
Crear lista
Operación
Crear lista
Clave de API de SendGrid*
••••••••
Nombre de la lista*
Nombre de la lista
Crear lista (
sendgrid_create_list)Crear una nueva lista de contactos en SendGrid
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave de API de SendGrid |
name | string | Sí | Nombre de la lista |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id | string | ID de lista |
name | string | Nombre de la lista |
contactCount | number | Número de contactos en la lista |
Obtener lista
Operación
Obtener lista
Clave de API de SendGrid*
••••••••
ID de lista*
ID de lista
Obtener lista (
sendgrid_get_list)Obtener una lista específica por ID de SendGrid
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave de API de SendGrid |
listId | string | Sí | ID de lista |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id | string | ID de lista |
name | string | Nombre de la lista |
contactCount | number | Número de contactos en la lista |
Listar todas las listas
Operación
Listar todas las listas
Clave de API de SendGrid*
••••••••
Tamaño de página
100
Listar todas las listas (
sendgrid_list_all_lists)Obtener todas las listas de contactos de SendGrid
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave API de SendGrid |
pageSize | number | No | Número de listas a devolver por página (valor predeterminado: 100) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
lists | json | Array de listas |
Eliminar lista
Operación
Eliminar lista
Clave API de SendGrid*
••••••••
ID de lista*
ID de lista
Eliminar lista (
sendgrid_delete_list)Eliminar una lista de contactos de SendGrid
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave de API de SendGrid |
listId | string | Sí | ID de la lista que se va a eliminar |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
message | string | Mensaje de éxito |
Añadir contactos a la lista
Operación
Añadir contactos a la lista
Clave de API de SendGrid*
••••••••
Contactos (matriz JSON)*
json
[{"email": "user@example.com", "first_name": "John"}]
ID de lista*
ID de lista
Añadir contactos a la lista (
sendgrid_add_contacts_to_list)Añadir o actualizar contactos y asignarlos a una lista en SendGrid (usa PUT /v3/marketing/contacts)
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave de API de SendGrid |
listId | string | Sí | ID de lista a la que añadir los contactos |
contacts | json | Sí | Array JSON de objetos de contacto. Cada contacto debe tener al menos: email (o phone_number_id/external_id/anonymous_id). Ejemplo: [{"email": "user@example.com", "first_name": "John"}] |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
jobId | string | ID de trabajo para el seguimiento de la operación asíncrona |
message | string | Mensaje de estado |
Quitar contactos de la lista
Operación
Quitar contactos de la lista
Clave de API de SendGrid*
••••••••
IDs de contacto*
IDs de contacto separados por comas
ID de lista*
ID de lista
Eliminar contactos de la lista (
sendgrid_remove_contacts_from_list)Eliminar contactos de una lista específica en SendGrid
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave de API de SendGrid |
listId | string | Sí | ID de lista |
contactIds | string | Sí | IDs de contactos separados por comas para eliminar de la lista |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
jobId | string | ID de trabajo de la solicitud |
Crear plantilla
Operación
Crear plantilla
Clave de API de SendGrid*
••••••••
Nombre de la plantilla*
Nombre de la plantilla
Generación de plantilla
Dinámica
Crear plantilla (
sendgrid_create_template)Crear una nueva plantilla de correo electrónico en SendGrid
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave de API de SendGrid |
name | string | Sí | Nombre de la plantilla |
generation | string | No | Tipo de generación de plantilla (legacy o dynamic, valor predeterminado: dynamic) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id | string | ID de plantilla |
name | string | Nombre de la plantilla |
generation | string | Generación de plantilla |
updatedAt | string | Marca de tiempo de la última actualización |
versions | json | Array de versiones de plantilla |
Obtener plantilla
Operación
Obtener plantilla
Clave de API de SendGrid*
••••••••
ID de plantilla*
ID de plantilla
Obtener plantilla (
sendgrid_get_template)Obtener una plantilla específica por ID de SendGrid
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave API de SendGrid |
templateId | string | Sí | ID de plantilla |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id | string | ID de plantilla |
name | string | Nombre de la plantilla |
generation | string | Generación de la plantilla |
updatedAt | string | Marca de tiempo de la última actualización |
versions | json | Array de versiones de la plantilla |
Listar plantillas
Operación
Listar plantillas
Clave API de SendGrid*
••••••••
Filtrar por generación
legacy, dynamic o ambas
Tamaño de página
20
Listar plantillas (
sendgrid_list_templates)Obtener todas las plantillas de correo electrónico de SendGrid
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave de API de SendGrid |
generations | string | No | Filtrar por generación (legacy, dynamic o both) |
pageSize | number | No | Número de plantillas que se devuelven por página (predeterminado: 20) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
templates | json | Array de plantillas |
Eliminar plantilla
Operación
Eliminar plantilla
Clave de API de SendGrid*
••••••••
ID de plantilla*
ID de plantilla
Eliminar plantilla (
sendgrid_delete_template)Eliminar una plantilla de correo electrónico de SendGrid
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave de API de SendGrid |
templateId | string | Sí | ID de plantilla que se eliminará |
Salida (contrato a nivel de bloque)
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Estado de éxito de la operación |
message | string | Mensaje de estado o de éxito |
messageId | string | ID del mensaje de correo (send_mail) |
to | string | Dirección de correo del destinatario (send_mail) |
subject | string | Asunto del correo (send_mail, create_template_version) |
id | string | ID del recurso |
jobId | string | ID del trabajo para operaciones asíncronas |
email | string | Dirección de correo del contacto |
firstName | string | Nombre del contacto |
lastName | string | Apellido del contacto |
createdAt | string | Marca de tiempo de creación |
updatedAt | string | Marca de tiempo de la última actualización |
listIds | json | Matriz de ID de listas a las que pertenece el contacto |
customFields | json | Valores de campos personalizados |
contacts | json | Matriz de contactos |
contactCount | number | Número de contactos |
lists | json | Matriz de listas |
name | string | Nombre del recurso |
templates | json | Matriz de plantillas |
generation | string | Generación de la plantilla |
versions | json | Matriz de versiones de plantilla |
templateId | string | ID de plantilla |
active | boolean | Si la versión de la plantilla está activa |
htmlContent | string | Contenido HTML |
plainContent | string | Contenido de texto sin formato |
Crear versión de plantilla
Operación
Crear versión de plantilla
Clave API de SendGrid*
••••••••
ID de plantilla*
ID de plantilla
Nombre de la versión*
Nombre de la versión
Asunto de la plantilla*
Asunto del correo
Contenido HTML
html
<html><body>{{name}}</body></html>
Contenido de texto plano
Contenido de texto plano
Activo
Sí
Crear versión de plantilla (
sendgrid_create_template_version)Crear una nueva versión de una plantilla de correo electrónico en SendGrid
Entrada
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Sí | Clave API de SendGrid |
templateId | string | Sí | ID de plantilla |
name | string | Sí | Nombre de la versión |
subject | string | Sí | Asunto del correo |
htmlContent | string | No | Contenido HTML de la plantilla |
plainContent | string | No | Contenido de texto plano de la plantilla |
active | boolean | No | Si esta versión está activa (valor predeterminado: true) |
Salida
| Parameter | Type | Description |
|---|---|---|
id | string | ID de versión |
templateId | string | ID de plantilla |
name | string | Nombre de la versión |
subject | string | Asunto del correo |
active | boolean | Si esta versión está activa |
htmlContent | string | Contenido HTML |
plainContent | string | Contenido de texto plano |
updatedAt | string | Marca de tiempo de la última actualización |
Instrucciones de uso
Integra SendGrid en tu workflow. Envía correos transaccionales, gestiona contactos y listas de marketing, y trabaja con plantillas de correo. Admite plantillas dinámicas, archivos adjuntos y una gestión integral de contactos.
Notas
- Categoría:
tools - Tipo:
sendgrid