SendGrid
SendGrid Connection Provider lets you send email and manage recipient lists.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure China regions - US Department of Defense (DoD) |
| Power Automate | Standard | All Power Automate regions except the following: - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Apps | Standard | All Power Apps regions except the following: - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Microsoft |
| URL | Microsoft LogicApps Support Microsoft Power Automate Support Microsoft Power Apps Support |
| Connector Metadata | |
|---|---|
| Publisher | Microsoft |
| Website | https://sendgrid.com/ |
| Privacy policy | https://www.twilio.com/legal/privacy |
Known issues and limitations
- SendGrid attachments don't use a format that's compatible with the other connectors. To resolve this problem when submitting an attachment, explicitly set the attachment fields, such as Content, ContentType, and Attachment File Name, for each attachment file.
Requirements
- A SendGrid account and a SendGrid API key that authorizes connections to your SendGrid account
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is shareable connection. If the power app is shared with another user, connection is shared as well. For more information, please see the Connectors overview for canvas apps - Power Apps | Microsoft Docs
| Name | Type | Description | Required |
|---|---|---|---|
| SendGrid Api Key | securestring | SendGrid Api Key | True |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 1200 | 60 seconds |
Actions
| Add a global suppression |
Add a global suppression |
| Add recipient to list |
Add an individual recipient to a recipient list. |
| Check if email is in unsubscribed email list |
Check if email is in unsubscribed email list. |
| Delete an email from bounce list |
Delete an email address from your bounce list. |
| Delete the global suppression |
Delete the global suppression |
| Get bounce for an email |
Get a specific bounce for a given email address. |
| Get the global suppression |
Get the global suppression |
| Send email (V2) [DEPRECATED] |
This action has been deprecated. Please use Send email (V4) instead.
|
| Send email (V3) [DEPRECATED] |
This action has been deprecated. Please use Send email (V4) instead.
|
| Send email (V4) |
Sends an email (V4). Limited to 1000 recipients. |
Add a global suppression
Add a global suppression
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Recipient email
|
recipient_emails | array of string |
Recipient email |
Returns
Add global suppress Response
Add recipient to list
Add an individual recipient to a recipient list.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
List id
|
listId | True | string |
Unique id of the recipient list. |
|
Recipient id
|
recipientId | True | string |
Unique id of the recipient. |
Returns
- response
- object
Check if email is in unsubscribed email list
Check if email is in unsubscribed email list.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Email
|
True | string |
The email to check. |
Returns
Email Is Unsubscribed Response
- Email Is Unsubscribed Response
- EmailIsUnsubscribedResponse
Delete an email from bounce list
Delete an email address from your bounce list.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Email
|
True | string |
The email to delete. |
Delete the global suppression
Delete the global suppression
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Email
|
True | string |
The email to delete. |
Get bounce for an email
Get a specific bounce for a given email address.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Email
|
True | string |
The email to check. |
Returns
List of bounces
- Items
- Bounces
Get the global suppression
Get the global suppression
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Email
|
True | string |
The email to check. |
Returns
Add global suppress Response
Send email (V2) [DEPRECATED]
This action has been deprecated. Please use Send email (V4) instead.
Sends an email (V2). Limited to 1000 recipients.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
From
|
from | True |
Origination address of your email. Must be a valid email address from your domain |
|
|
From name
|
fromname | string |
Origination name of your email |
|
|
To
|
to | True |
Valid email addresses separated by a semicolon or comma |
|
|
To names
|
toname | string |
A display name for each email address separated by a semicolon or comma |
|
|
Subject
|
subject | True | string |
Subject of your email |
|
Email body
|
text | True | string |
Content of your email |
|
Is Html
|
ishtml | boolean |
Specify whether the content of the email is HTML or plain text |
|
|
CC
|
cc |
Valid email addresses separated by a semicolon or comma |
||
|
CC names
|
ccname | string |
A display name for each CC email address separated by a semicolon or comma |
|
|
Bcc
|
bcc |
Valid email addresses separated by a semicolon or comma |
||
|
BCC names
|
bccname | string |
A display name for each BCC email address separated by a semicolon or comma |
|
|
Attachment
|
file | byte |
Attachment file content |
|
|
Attachment file name
|
filename | string |
Attachment file name |
Returns
- response
- object
Send email (V3) [DEPRECATED]
This action has been deprecated. Please use Send email (V4) instead.
Sends an email (V3). Limited to 1000 recipients.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
From
|
from | True |
Origination address of your email. Must be a valid email address from your domain |
|
|
From name
|
fromname | string |
Origination name of your email |
|
|
To
|
to | True |
Valid email addresses separated by a semicolon or comma |
|
|
To names
|
toname | string |
A display name for each email address separated by a semicolon or comma |
|
|
Subject
|
subject | True | string |
Subject of your email |
|
Email body
|
text | True | html |
Content of your email |
|
CC
|
cc |
Valid email addresses separated by a semicolon or comma |
||
|
CC names
|
ccname | string |
A display name for each CC email address separated by a semicolon or comma |
|
|
Bcc
|
bcc |
Valid email addresses separated by a semicolon or comma |
||
|
BCC names
|
bccname | string |
A display name for each BCC email address separated by a semicolon or comma |
|
|
Attachment
|
file | byte |
Attachment file content |
|
|
Attachment file name
|
filename | string |
Attachment file name |
Returns
- response
- object
Send email (V4)
Sends an email (V4). Limited to 1000 recipients.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Content
|
content | byte |
Attachment file content |
|
|
Name
|
filename | string |
Attachment file name |
|
|
ContentType
|
contenttype | string |
Type of content in the attachment. |
|
|
From
|
from | True |
Origination address of your email. Must be a valid email address from your domain |
|
|
From name
|
fromname | string |
Origination name of your email |
|
|
To
|
to | True |
Valid email addresses separated by a semicolon or comma |
|
|
To names
|
toname | string |
A display name for each email address separated by a semicolon or comma |
|
|
Subject
|
subject | True | string |
Subject of your email |
|
Email body
|
text | True | html |
Content of your email |
|
CC
|
cc |
Valid email addresses separated by a semicolon or comma |
||
|
CC names
|
ccname | string |
A display name for each CC email address separated by a semicolon or comma |
|
|
Bcc
|
bcc |
Valid email addresses separated by a semicolon or comma |
||
|
BCC names
|
bccname | string |
A display name for each BCC email address separated by a semicolon or comma |
Returns
- response
- object
Definitions
AddGlobalSuppressRequestAndResponse
Add global suppress Response
| Name | Path | Type | Description |
|---|---|---|---|
|
Recipient email
|
recipient_emails | array of string |
Recipient email |
GetGlobalSuppressResponse
Add global suppress Response
| Name | Path | Type | Description |
|---|---|---|---|
|
Recipient email
|
recipient_email | string |
Recipient email |
Bounces
List of bounces
| Name | Path | Type | Description |
|---|---|---|---|
|
Items
|
Bounce |
Get Bounce Response |
EmailIsUnsubscribedResponse
Email Is Unsubscribed Response
| Name | Path | Type | Description |
|---|---|---|---|
|
Is Email Unsubscribed
|
isUnsubscribed | boolean |
Is Email Unsubscribed |
Bounce
Get Bounce Response
| Name | Path | Type | Description |
|---|---|---|---|
|
Created
|
created | integer |
Created |
|
Email
|
string |
|
|
|
Reason
|
reason | string |
Reason |
|
Status
|
status | string |
Status |
object
This is the type 'object'.