SUPPORT.TWILIO.COM END OF LIFE NOTICE: This site,, is scheduled to go End of Life on February 27, 2024. All Twilio Support content has been migrated to, where you can continue to find helpful Support articles, API docs, and Twilio blog content, and escalate your issues to our Support team. We encourage you to update your bookmarks and begin using the new site today for all your Twilio Support needs.

Email Integration: SendGrid API key is not correct or doesn't have the required permissions

In Authy / Verify, when the API key you are using does not have the proper permissions, or the template ID is not correct, the email integration will return the error SendGrid API key is not correct or doesn't have the required permissions. This guide explains how to resolve this issue.


Check API key permissions

If you are seeing the above error, we recommend first checking to see that the API key has the proper permissions.

  1. Log into SendGrid UI
  2. Go to the API key page. 
  3. Click on the Gear icon mceclip0.png on the right to Edit API Key.
  4. Find the Access details for Template Engine at the bottom of the list and make sure it has Read Access.

  5. Click Update.
  6. Save the email integration configuration on the Twilio console. 

Verify your Template ID

If your API key has the proper permissions, next check to see that the Template ID you're using is correct.

  1. Go to the Dynamic Templates page on SendGrid.
  2. Click on the template's name to expand the versions available.
  3. Check the template ID matches with the one entered on Twilio console:


  4. Copy the template ID to avoid any typos and paste it on the DEFAULT TEMPLATE ID field in the email integration configuration on Twilio Console.


  5. Save the email integration configuration. 
Have more questions? Submit a request
Powered by Zendesk