Twilio SendGrid Single Sign-On is currently in beta. The following documentation and product interface may change as the product is improved.
The following guide will help you add Twilio SendGrid Single Sign-On (SSO) as an integration to your Okta Admin Console. This guide covers the steps necessary to work with Okta only. The following prerequisites should be completed before proceeding with this guide.
Adding an SSO configuration requires some back-and-forth between the Service Provider (Twilio SendGrid) and your IdP (Okta). The Twilio SendGrid App will provide values required by Okta. Likewise, Okta will provide values required by Twilio SendGrid. You should retrieve values from the Twilio SendGrid App for the fields listed in the following table before proceeding. To understand how to retrieve these values, please follow the instructions in our main SSO documentation.
Twilio SendGrid, Okta, and other identity providers often refer to the same values by different names. The table below provides the name used by both Okta and Twilio SendGrid, a short description for each required field, and which application provides the information during setup.
|Twilio SendGrid label||Okta label||Provided by||Description|
|Name||Name||Twilio SendGrid||The name of your integration. This name can be anything that makes sense for your organization (e.g., "Twilio SendGrid" or "Email")|
|Single Sign-On URL||Single sign on URL||Twilio SendGrid||The URL where Okta should POST its SAML response. This URL is responsible for receiving and parsing a SAML assertion. This is the same URL as the Audience URL when using Twilio SendGrid.|
|Audience URL (SP Entity ID)||Audience URL (SP Entity ID)||Twilio SendGrid||The URL where Okta should POST its SAML response. This URL is responsible for receiving and parsing a SAML assertion. This is the same URL as the Single Sign-On URL when using Twilio SendGrid.|
|N/A||Application username||N/A||This should be set to "Email" when using Twilio SendGrid.|
|Embed Link||Identity Provider Single Sign-On URL||Okta||Okta's SAML POST endpoint. This endpoint should receive requests and initiate an SSO login flow.|
|SAML Issuer ID||Identity Provider Issuer||Okta||An identifier provided by Okta to identify Twilio SendGrid in the SAML interaction.|
|X509 Certificate||X.509 Certificate||Okta||This certificate is used by Twilio SendGrid to verify that SAML requests are coming from Okta.|
With the prerequisite values prepared, you can begin adding your Application in the Okta Developer Console. The URL for this console will likely follow the pattern:
You can download the Twilio SendGrid logo from our brand assets page at https://sendgrid.com/resource/brand/.
Single Sign on URL: The Single Sign-on URL provided by the Twilio SendGrid App.
Group Attribute Statements (optional)
Once you have added Twilio SendGrid to Okta, you may need to modify the integration.
Once you complete your Okta configuration in the Twilio SendGrid App, you will be able to manage your users.
To further manage users, remove an IdP integration, or make other changes to your integration, please return to the main Twilio SendGrid SAML SSO documentation for next steps.
Okta provides its own developer documentation, which may be helpful depending on your integration needs.
Let us know how we’re doing! Please rate this page:
Please note, we cannot resolve account and login issues reported on GitHub. Contact support for account assistance.
Thanks for helping us improve our docs!