Using Your Own SendGrid Account With App ID

3 min read

Configuring App ID to use your own SendGrid account to send your app users emails.

With IBM Cloud App ID, you can easily add authentication, authorization, and user profile services to web apps, mobile apps, and APIs with minimal to zero code changes, all without redeploying your app. App ID's Cloud Directory allows you to manage your users in a scalable registry by using a pre-built functionality that enhances security and self-service.

When you're using Cloud Directory, you might want to communicate with your users through automated emails when they perform certain tasks in your application. For example, when a user signs up to your app, you might want to send them a welcome email. Additionally, you might also send a verification email where the user can validate that they have access to the email with which they used to sign up. By default, emails are sent through App ID's SendGrid account.

SendGrid is an email provider that provides a cloud-based service that manages your email deliveries through simple APIs. It tracks emails delivered, opened, reported as spam, and more.

In this blog post, I'll walk you through all of the things that you can gain when you use your own email provider (such as SendGrid), and I'll show you how to configure your App ID instance to work with your own SendGrid account.

Working with an email provider other than SendGrid? No problem! Check out the blog "Using your own email provider for mail that is sent with App ID."

Note: You can also configure a custom email provider with our new UI.

What do I gain by using my own email provider instead of the default?

When you configure App ID to use your own email provider, you are able to do the following:

  • Reduce the risk of your emails being filtered as spam.
  • Increase brand awareness for your application by using a company email address, such as no-reply@your-company.com.
  • Edit App ID's default email templates, such as a Welcome Email or sender details.
    • Note: As of April 30, 2020, email content and sender details are no longer editable if you’re using the App ID default email provider. To customize your user communication, add your own SendGrid account or custom email provider.
  • Monitor email analytics like which emails are opened or haven't been delivered, which allows for you to learn about how your users are interacting with your emails.

Configuring App ID to use your own SendGrid account

  1. Create a SendGrid account.
  2. Create a SendGrid API key. 
    • Sign-in to SendGrid and go to Settings > API Keys
    • Click Create API Key. Enter a name and choose the desired permissions for your key.
  3. Add the API key to App ID.
    • Open the App ID dashboard, and go to Cloud Directory > Email Templates.
    • Under Email provider, choose SendGrid and enter your SendGrid API key.
      Under Email provider, choose SendGrid and enter your SendGrid API key.

  4. Test your configuration.
    • Click Test. In the screen that opens, enter an email address where you would like to receive the test email, then click Test
      Click Test. In the screen that opens, enter an email address where you would like to receive the test email, then click Test. 

    • Check your email and verify that you received the test email.
      Check your email and verify that you received the test email.

  5. When you're happy with your email flow, click Save to start using your new email provider.

That's it!

In this post, I showed you how to configure App ID to work with your own SendGrid account. I hope that you are now ready to give using your own email provider a try now that you've seen how simple it is to configure your own SendGrid account.

Questions and feedback

We'd love to hear from you with feedback! Have questions, comments, or concerns? Let us know:

  • Reach out directly to the development team on Slack!
  • If you have technical questions about App ID, post your question on Stack Overflow and tag your question with ibm-appid.
  • For questions about the service and getting started instructions, use the IBM Developer Answers forum. Include the appid tag.
  • Open a support ticket in the IBM Cloud menu.

New to App ID? Welcome! To get started, check it out in the IBM Cloud Catalog.

Be the first to hear about news, product updates, and innovation from IBM Cloud