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

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.

Sends an email (V2). Limited to 1000 recipients.

Send email (V3) [DEPRECATED]

This action has been deprecated. Please use Send email (V4) instead.

Sends an email (V3). Limited to 1000 recipients.

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
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
email True string

The email to delete.

Delete the global suppression

Delete the global suppression

Parameters

Name Key Required Type Description
Email
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
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
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 email

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 email

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 email

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 email

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 email

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 email

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 email

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 email

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 email

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 email

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 email

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 email

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
email string

Email

Reason
reason string

Reason

Status
status string

Status

object

This is the type 'object'.