Loading...
Skip to main content

Gmail

This is the documentation for the Courier Gmail email provider.

Authorizing Courier for Gmail​

When you set up Gmail as a provider and connect your gmail account, Courier will request permission to send emails on your behalf. Courier will not send any emails unless you explicitly make a send request using the provider.

Gmail Quota Rate Limits

Gmail's API has limitations based on per-method quota usage (250 per second) thus Gmail is really intended for getting started fast, testing, or small-scale sending. Courier has a variety of email provider integrations that won't rate limit you.

OAuth Authorization​

Google APIs use the OAuth protocol for authentication and authorization. Once given permission, Courier will request an access token from the Google Authorization Server, and send the token to the Google Gmail API on your behalf.

To give Courier access to your Gmail credentials, you will need to consent to Courier's requested Gmail scopes by signing into your desired Gmail inbox and allowing Courier permission.

Updating Authorized Account​

On the Gmail Integration page, you can click on "Authorize a different Gmail inbox" to send messages from a different account. This will require you to give permissions for the new email account every time you change the account.

Profile Requirements​

To deliver a message to a recipient over Gmail, Courier must be provided the recipient's email address. This value should be included in the recipient profile as email.

{
  "message": {
    // Recipient Profile
    "to": {
      "email": "example@example.com"
    }

    // ... rest of message definition
  }
}

Override​

The Gmail provider will support overrides soon.