sendgrid

Server path: /sendgrid | Type: Application | PCID required: Yes Email campaigns and contacts

Tools

Tool	Description
`sendgrid_send_email`	Send an email via SendGrid. Supports HTML/plain text, CC/BCC, attachments via URL, and SendGrid templates
`sendgrid_create_template`	Create a new email template container in SendGrid. After creating, use sendgrid_create_template_version to add content
`sendgrid_get_template`	Retrieve an email template including all versions. Returns template metadata and version content
`sendgrid_list_templates`	List all email templates in SendGrid. Returns template IDs needed for sendgrid_send_email
`sendgrid_create_template_version`	Create a new version of an email template
`sendgrid_update_template_version`	Update an existing template version
`sendgrid_add_contact`	Add a contact to SendGrid
`sendgrid_get_contact`	Retrieve a contact by ID or email
`sendgrid_update_contact`	Update an existing contact
`sendgrid_delete_contact`	Delete a contact from SendGrid
`sendgrid_create_list`	Create a new contact list
`sendgrid_get_list`	Retrieve a contact list by ID
`sendgrid_list_contacts`	List all contacts with optional filtering
`sendgrid_search_contacts`	Search contacts using SendGrid query language
`sendgrid_add_contacts_to_list`	Add contacts to a specific list
`sendgrid_remove_contacts_from_list`	Remove contacts from a specific list
`sendgrid_get_email_stats`	Get email statistics for a date range
`sendgrid_get_bounce_stats`	Get bounce statistics
`sendgrid_get_suppression_groups`	List all suppression groups (unsubscribe groups)
`sendgrid_create_suppression_group`	Create a new suppression group
`sendgrid_validate_email`	Validate an email address using SendGrid validation

sendgrid_send_email

Send an email via SendGrid. Supports HTML/plain text, CC/BCC, attachments via URL, and SendGrid templates Parameters:

Parameter	Type	Required	Default	Description
`to`	object[]	Yes	—	Recipients array. Example: [{“email”: “john@example.com”, “name”: “John Smith”}]
`from`	object	Yes	—	Sender info. Email must be verified domain/address in SendGrid
`subject`	string	Yes	—	Email subject line. Example: “Your Order Confirmation”
`content`	object[]	Yes	—	Email body content. Provide both text/plain and text/html for best compatibility. Example: [{“type”: “text/plain”, “value”: “Hello”}, {“type”: “text/html”, “value”: “<p>Hello</p>”}]
`reply_to`	object	No	—	Reply-to address (where replies go if different from sender)
`cc`	object[]	No	—	CC recipients (visible to all). Example: [{“email”: “cc@example.com”}]
`bcc`	object[]	No	—	BCC recipients (hidden from others). Example: [{“email”: “archive@example.com”}]
`attachments`	object[]	No	—	Pre-encoded attachments (base64). Use attachmentUrls for URL-based attachments
`attachmentUrls`	string[]	No	—	URLs of files to attach. Files will be fetched and attached automatically. Example: [“https://example.com/report.pdf”]
`template_id`	string	No	—	SendGrid dynamic template ID. Get from sendgrid_list_templates. When used, subject and content may be optional
`dynamic_template_data`	object	No	—	Template variable substitutions. Example: {“firstName”: “John”, “orderNumber”: “12345”}

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for SendGrid connection"
    },
    "to": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "description": "Recipient email address"
          },
          "name": {
            "type": "string",
            "description": "Display name (shows in recipient field)"
          }
        }
      },
      "description": "Recipients array. Example: [{\"email\": \"john@example.com\", \"name\": \"John Smith\"}]"
    },
    "from": {
      "type": "object",
      "properties": {
        "email": {
          "type": "string",
          "description": "Sender email (must be verified in SendGrid)"
        },
        "name": {
          "type": "string",
          "description": "Display name for sender. Example: \"My Company\""
        }
      },
      "description": "Sender info. Email must be verified domain/address in SendGrid"
    },
    "subject": {
      "type": "string",
      "description": "Email subject line. Example: \"Your Order Confirmation\""
    },
    "content": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "text/plain",
              "text/html"
            ],
            "description": "Content type: \"text/plain\" for plain text, \"text/html\" for HTML"
          },
          "value": {
            "type": "string",
            "description": "Email content. HTML example: \"<p>Hello <b>World</b></p>\""
          }
        }
      },
      "description": "Email body content. Provide both text/plain and text/html for best compatibility. Example: [{\"type\": \"text/plain\", \"value\": \"Hello\"}, {\"type\": \"text/html\", \"value\": \"<p>Hello</p>\"}]"
    },
    "reply_to": {
      "type": "object",
      "properties": {
        "email": {
          "type": "string",
          "description": "Email address for replies. Example: \"support@example.com\""
        },
        "name": {
          "type": "string",
          "description": "Display name for reply-to"
        }
      },
      "description": "Reply-to address (where replies go if different from sender)"
    },
    "cc": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "description": "CC email address"
          },
          "name": {
            "type": "string",
            "description": "CC display name"
          }
        }
      },
      "description": "CC recipients (visible to all). Example: [{\"email\": \"cc@example.com\"}]"
    },
    "bcc": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "description": "BCC email address"
          },
          "name": {
            "type": "string",
            "description": "BCC display name"
          }
        }
      },
      "description": "BCC recipients (hidden from others). Example: [{\"email\": \"archive@example.com\"}]"
    },
    "attachments": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "content": {
            "type": "string",
            "description": "Base64-encoded file content"
          },
          "filename": {
            "type": "string",
            "description": "Filename to display. Example: \"report.pdf\""
          },
          "type": {
            "type": "string",
            "description": "MIME type. Example: \"application/pdf\", \"image/png\""
          },
          "disposition": {
            "type": "string",
            "enum": [
              "attachment",
              "inline"
            ],
            "default": "attachment",
            "description": "\"attachment\" for downloadable, \"inline\" for embedded images"
          }
        }
      },
      "description": "Pre-encoded attachments (base64). Use attachmentUrls for URL-based attachments"
    },
    "attachmentUrls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "URLs of files to attach. Files will be fetched and attached automatically. Example: [\"https://example.com/report.pdf\"]"
    },
    "template_id": {
      "type": "string",
      "description": "SendGrid dynamic template ID. Get from sendgrid_list_templates. When used, subject and content may be optional"
    },
    "dynamic_template_data": {
      "type": "object",
      "additionalProperties": true,
      "description": "Template variable substitutions. Example: {\"firstName\": \"John\", \"orderNumber\": \"12345\"}"
    }
  },
  "required": [
    "PCID",
    "to",
    "from",
    "subject",
    "content"
  ]
}

sendgrid_create_template

Create a new email template container in SendGrid. After creating, use sendgrid_create_template_version to add content Parameters:

Parameter	Type	Required	Default	Description
`name`	string	Yes	—	Template name for identification. Example: “Order Confirmation”, “Welcome Email”
`generation`	string	No	`"dynamic"`	”dynamic” for templates with {{handlebar}} variables (recommended). “legacy” for older format

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for SendGrid connection"
    },
    "name": {
      "type": "string",
      "description": "Template name for identification. Example: \"Order Confirmation\", \"Welcome Email\""
    },
    "generation": {
      "type": "string",
      "enum": [
        "legacy",
        "dynamic"
      ],
      "default": "dynamic",
      "description": "\"dynamic\" for templates with {{handlebar}} variables (recommended). \"legacy\" for older format"
    }
  },
  "required": [
    "PCID",
    "name"
  ]
}

sendgrid_get_template

Retrieve an email template including all versions. Returns template metadata and version content Parameters:

Parameter	Type	Required	Default	Description
`template_id`	string	Yes	—	Template ID to retrieve. Get from sendgrid_list_templates or sendgrid_create_template response

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for SendGrid connection"
    },
    "template_id": {
      "type": "string",
      "description": "Template ID to retrieve. Get from sendgrid_list_templates or sendgrid_create_template response"
    }
  },
  "required": [
    "PCID",
    "template_id"
  ]
}

sendgrid_list_templates

List all email templates in SendGrid. Returns template IDs needed for sendgrid_send_email Parameters:

Parameter	Type	Required	Default	Description
`generations`	string	No	—	Filter by type. “dynamic” = modern templates with variables. Default: returns all
`page_size`	number	No	`50`	Number of templates per page. Default: 50. Max: 200

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for SendGrid connection"
    },
    "generations": {
      "type": "string",
      "enum": [
        "legacy",
        "dynamic"
      ],
      "description": "Filter by type. \"dynamic\" = modern templates with variables. Default: returns all"
    },
    "page_size": {
      "type": "number",
      "default": 50,
      "description": "Number of templates per page. Default: 50. Max: 200"
    }
  },
  "required": [
    "PCID"
  ]
}

sendgrid_create_template_version

Create a new version of an email template Parameters:

Parameter	Type	Required	Default	Description
`template_id`	string	Yes	—	Template ID
`name`	string	Yes	—	Version name
`subject`	string	Yes	—	Email subject template
`html_content`	string	No	—	HTML content template
`plain_content`	string	No	—	Plain text content template
`active`	boolean	No	`false`	Whether this version is active
`test_data`	object	No	—	Test data for template variables

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "template_id": {
      "type": "string",
      "description": "Template ID"
    },
    "name": {
      "type": "string",
      "description": "Version name"
    },
    "subject": {
      "type": "string",
      "description": "Email subject template"
    },
    "html_content": {
      "type": "string",
      "description": "HTML content template"
    },
    "plain_content": {
      "type": "string",
      "description": "Plain text content template"
    },
    "active": {
      "type": "boolean",
      "default": false,
      "description": "Whether this version is active"
    },
    "test_data": {
      "type": "object",
      "additionalProperties": true,
      "description": "Test data for template variables"
    }
  },
  "required": [
    "PCID",
    "template_id",
    "name",
    "subject"
  ]
}

sendgrid_update_template_version

Update an existing template version Parameters:

Parameter	Type	Required	Default	Description
`template_id`	string	Yes	—	Template ID
`version_id`	string	Yes	—	Version ID to update
`name`	string	No	—	Version name
`subject`	string	No	—	Email subject template
`html_content`	string	No	—	HTML content template
`plain_content`	string	No	—	Plain text content template
`active`	boolean	No	—	Whether this version is active

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "template_id": {
      "type": "string",
      "description": "Template ID"
    },
    "version_id": {
      "type": "string",
      "description": "Version ID to update"
    },
    "name": {
      "type": "string",
      "description": "Version name"
    },
    "subject": {
      "type": "string",
      "description": "Email subject template"
    },
    "html_content": {
      "type": "string",
      "description": "HTML content template"
    },
    "plain_content": {
      "type": "string",
      "description": "Plain text content template"
    },
    "active": {
      "type": "boolean",
      "description": "Whether this version is active"
    }
  },
  "required": [
    "PCID",
    "template_id",
    "version_id"
  ]
}

sendgrid_add_contact

Add a contact to SendGrid Parameters:

Parameter	Type	Required	Default	Description
`email`	string	Yes	—	Contact email address
`first_name`	string	No	—	Contact first name
`last_name`	string	No	—	Contact last name
`custom_fields`	object	No	—	Custom field values for the contact
`list_ids`	string[]	No	—	List IDs to add the contact to

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "email": {
      "type": "string",
      "description": "Contact email address"
    },
    "first_name": {
      "type": "string",
      "description": "Contact first name"
    },
    "last_name": {
      "type": "string",
      "description": "Contact last name"
    },
    "custom_fields": {
      "type": "object",
      "additionalProperties": true,
      "description": "Custom field values for the contact"
    },
    "list_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List IDs to add the contact to"
    }
  },
  "required": [
    "PCID",
    "email"
  ]
}

sendgrid_get_contact

Retrieve a contact by ID or email Parameters:

Parameter	Type	Required	Default	Description
`contact_id`	string	No	—	Contact ID
`email`	string	No	—	Contact email address

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "contact_id": {
      "type": "string",
      "description": "Contact ID"
    },
    "email": {
      "type": "string",
      "description": "Contact email address"
    }
  },
  "required": [
    "PCID"
  ]
}

sendgrid_update_contact

Update an existing contact Parameters:

Parameter	Type	Required	Default	Description
`contact_id`	string	Yes	—	Contact ID to update
`email`	string	No	—	New email address
`first_name`	string	No	—	New first name
`last_name`	string	No	—	New last name
`custom_fields`	object	No	—	Updated custom field values

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "contact_id": {
      "type": "string",
      "description": "Contact ID to update"
    },
    "email": {
      "type": "string",
      "description": "New email address"
    },
    "first_name": {
      "type": "string",
      "description": "New first name"
    },
    "last_name": {
      "type": "string",
      "description": "New last name"
    },
    "custom_fields": {
      "type": "object",
      "additionalProperties": true,
      "description": "Updated custom field values"
    }
  },
  "required": [
    "PCID",
    "contact_id"
  ]
}

sendgrid_delete_contact

Delete a contact from SendGrid Parameters:

Parameter	Type	Required	Default	Description
`contact_id`	string	Yes	—	Contact ID to delete

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "contact_id": {
      "type": "string",
      "description": "Contact ID to delete"
    }
  },
  "required": [
    "PCID",
    "contact_id"
  ]
}

sendgrid_create_list

Create a new contact list Parameters:

Parameter	Type	Required	Default	Description
`name`	string	Yes	—	List name

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "name": {
      "type": "string",
      "description": "List name"
    }
  },
  "required": [
    "PCID",
    "name"
  ]
}

sendgrid_get_list

Retrieve a contact list by ID Parameters:

Parameter	Type	Required	Default	Description
`list_id`	string	Yes	—	List ID to retrieve

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "list_id": {
      "type": "string",
      "description": "List ID to retrieve"
    }
  },
  "required": [
    "PCID",
    "list_id"
  ]
}

sendgrid_list_contacts

List all contacts with optional filtering Parameters:

Parameter	Type	Required	Default	Description
`page_size`	number	No	`100`	Number of contacts per page (1-1000)
`page_token`	string	No	—	Page token for pagination

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "page_size": {
      "type": "number",
      "default": 100,
      "description": "Number of contacts per page (1-1000)"
    },
    "page_token": {
      "type": "string",
      "description": "Page token for pagination"
    }
  },
  "required": [
    "PCID"
  ]
}

sendgrid_search_contacts

Search contacts using SendGrid query language Parameters:

Parameter	Type	Required	Default	Description
`query`	string	Yes	—	Search query using SendGrid query language (e.g., “email LIKE ’%@example.com’“)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "query": {
      "type": "string",
      "description": "Search query using SendGrid query language (e.g., \"email LIKE '%@example.com'\")"
    }
  },
  "required": [
    "PCID",
    "query"
  ]
}

sendgrid_add_contacts_to_list

Add contacts to a specific list Parameters:

Parameter	Type	Required	Default	Description
`list_id`	string	Yes	—	List ID
`contact_ids`	string[]	Yes	—	Array of contact IDs to add to the list

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "list_id": {
      "type": "string",
      "description": "List ID"
    },
    "contact_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of contact IDs to add to the list"
    }
  },
  "required": [
    "PCID",
    "list_id",
    "contact_ids"
  ]
}

sendgrid_remove_contacts_from_list

Remove contacts from a specific list Parameters:

Parameter	Type	Required	Default	Description
`list_id`	string	Yes	—	List ID
`contact_ids`	string[]	Yes	—	Array of contact IDs to remove from the list

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "list_id": {
      "type": "string",
      "description": "List ID"
    },
    "contact_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of contact IDs to remove from the list"
    }
  },
  "required": [
    "PCID",
    "list_id",
    "contact_ids"
  ]
}

sendgrid_get_email_stats

Get email statistics for a date range Parameters:

Parameter	Type	Required	Default	Description
`start_date`	string	Yes	—	Start date for stats (YYYY-MM-DD format)
`end_date`	string	Yes	—	End date for stats (YYYY-MM-DD format)
`aggregated_by`	string	No	`"day"`	How to aggregate the statistics
`tags`	string[]	No	—	Filter by specific tags
`categories`	string[]	No	—	Filter by specific categories

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "start_date": {
      "type": "string",
      "description": "Start date for stats (YYYY-MM-DD format)"
    },
    "end_date": {
      "type": "string",
      "description": "End date for stats (YYYY-MM-DD format)"
    },
    "aggregated_by": {
      "type": "string",
      "enum": [
        "day",
        "week",
        "month"
      ],
      "default": "day",
      "description": "How to aggregate the statistics"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by specific tags"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by specific categories"
    }
  },
  "required": [
    "PCID",
    "start_date",
    "end_date"
  ]
}

sendgrid_get_bounce_stats

Get bounce statistics Parameters:

Parameter	Type	Required	Default	Description
`start_date`	string	Yes	—	Start date for stats (YYYY-MM-DD format)
`end_date`	string	Yes	—	End date for stats (YYYY-MM-DD format)
`type`	string	No	—	Type of bounces to retrieve

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "start_date": {
      "type": "string",
      "description": "Start date for stats (YYYY-MM-DD format)"
    },
    "end_date": {
      "type": "string",
      "description": "End date for stats (YYYY-MM-DD format)"
    },
    "type": {
      "type": "string",
      "enum": [
        "hard",
        "soft"
      ],
      "description": "Type of bounces to retrieve"
    }
  },
  "required": [
    "PCID",
    "start_date",
    "end_date"
  ]
}

sendgrid_get_suppression_groups

List all suppression groups (unsubscribe groups)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    }
  },
  "required": [
    "PCID"
  ]
}

sendgrid_create_suppression_group

Create a new suppression group Parameters:

Parameter	Type	Required	Default	Description
`name`	string	Yes	—	Suppression group name
`description`	string	Yes	—	Suppression group description
`is_default`	boolean	No	`false`	Whether this is the default suppression group

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "name": {
      "type": "string",
      "description": "Suppression group name"
    },
    "description": {
      "type": "string",
      "description": "Suppression group description"
    },
    "is_default": {
      "type": "boolean",
      "default": false,
      "description": "Whether this is the default suppression group"
    }
  },
  "required": [
    "PCID",
    "name",
    "description"
  ]
}

sendgrid_validate_email

Validate an email address using SendGrid validation Parameters:

Parameter	Type	Required	Default	Description
`email`	string	Yes	—	Email address to validate
`source`	string	No	—	Source identifier for tracking validation requests

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "email": {
      "type": "string",
      "description": "Email address to validate"
    },
    "source": {
      "type": "string",
      "description": "Source identifier for tracking validation requests"
    }
  },
  "required": [
    "PCID",
    "email"
  ]
}

Triggers API

Platform API

Embedded MCP Servers

Application MCP Servers

Tools

sendgrid_send_email

sendgrid_create_template

sendgrid_get_template

sendgrid_list_templates

sendgrid_create_template_version

sendgrid_update_template_version

sendgrid_add_contact

sendgrid_get_contact

sendgrid_update_contact

sendgrid_delete_contact

sendgrid_create_list

sendgrid_get_list

sendgrid_list_contacts

sendgrid_search_contacts

sendgrid_add_contacts_to_list

sendgrid_remove_contacts_from_list

sendgrid_get_email_stats

sendgrid_get_bounce_stats

sendgrid_get_suppression_groups

sendgrid_create_suppression_group

sendgrid_validate_email

Triggers API

Platform API

Embedded MCP Servers

Application MCP Servers

​Tools

​sendgrid_send_email

​sendgrid_create_template

​sendgrid_get_template

​sendgrid_list_templates

​sendgrid_create_template_version

​sendgrid_update_template_version

​sendgrid_add_contact

​sendgrid_get_contact

​sendgrid_update_contact

​sendgrid_delete_contact

​sendgrid_create_list

​sendgrid_get_list

​sendgrid_list_contacts

​sendgrid_search_contacts

​sendgrid_add_contacts_to_list

​sendgrid_remove_contacts_from_list

​sendgrid_get_email_stats

​sendgrid_get_bounce_stats

​sendgrid_get_suppression_groups

​sendgrid_create_suppression_group

​sendgrid_validate_email

Tools

sendgrid_send_email

sendgrid_create_template

sendgrid_get_template

sendgrid_list_templates

sendgrid_create_template_version

sendgrid_update_template_version

sendgrid_add_contact

sendgrid_get_contact

sendgrid_update_contact

sendgrid_delete_contact

sendgrid_create_list

sendgrid_get_list

sendgrid_list_contacts

sendgrid_search_contacts

sendgrid_add_contacts_to_list

sendgrid_remove_contacts_from_list

sendgrid_get_email_stats

sendgrid_get_bounce_stats

sendgrid_get_suppression_groups

sendgrid_create_suppression_group

sendgrid_validate_email