{"registry_version":"2026.1025.387","generated_at":"2026-10-25T06:27:00Z","content_sha256":"089d16f627d9365e3d0663cc8069203706d7cb23a76c332226e29686968811a5","signed":true,"signature":{"key_id":"ed25519:74ca19268e364242","algorithm":"ed25519","expires_at":"2026-11-24T06:27:09Z","expired":false,"manifest":"/registry/manifest.json"},"entry_sha256":"be309f1be2ea56435e2c93d7231b996861bc4b3c03de2395cb68fb5bc22b030d","entry":{"id":"twilio/sendgrid","name":"Twilio SendGrid Email API","vendor":"Twilio SendGrid","summary":"Email API from Twilio SendGrid. You authenticate your sending domain with DNS records, then create a restricted API key with Mail Send access.","aliases":["sendgrid","twilio/sendgrid-email"],"category":"email","group":"A","homepage":"https://sendgrid.com/","docs":["https://www.twilio.com/docs/sendgrid"],"status":"researched","last_verified":null,"last_researched":"2026-10-25","sources":[{"id":"domain-auth","url":"https://www.twilio.com/docs/sendgrid/ui/account-and-settings/how-to-set-up-domain-authentication","title":"Twilio SendGrid docs - How to set up domain authentication","accessed":"2026-10-25","supports":"Settings > Sender Authentication flow; root domain only, subdomains don't inherit; automated security on by default gives 3 CNAMEs (em####, s1._domainkey, s2._domainkey) plus _dmarc TXT; off gives MX + TXT records; DNS verification can take up to 48 hours; doubled-domain and overwritten-CNAME troubleshooting","kind":"official"},{"id":"quickstart","url":"https://www.twilio.com/docs/sendgrid/for-developers/sending-email/quickstart-nodejs","title":"Twilio SendGrid docs - Email API Quickstart for Node.js","accessed":"2026-10-25","supports":"SENDGRID_API_KEY env var; Restricted Access key with Mail Send Full Access only; sender identity must be verified via domain authentication; Single Sender Verification for testing only","kind":"official"},{"id":"api-keys","url":"https://www.twilio.com/docs/sendgrid/ui/account-and-settings/api-keys","title":"Twilio SendGrid docs - API keys","accessed":"2026-10-25","supports":"Full Access, Custom Access, Billing Access and Email Address Validation Access permissions; console displays the API key only once at creation","kind":"official"}],"allowed_domains":["sendgrid.com","twilio.com"],"prerequisites":[{"need":"A domain you control with access to its DNS settings"}],"have_ready":[{"kind":"other","description":"DNS access for the root sending domain","why":"Sender identity is verified by domain authentication, which adds DNS records at your DNS host.","needed_for":["add-dns-records"],"auto_check":"dns_record","source":"quickstart"}],"steps":[{"id":"sign-in","title":"Sign in or create a Twilio SendGrid account","summary":"Sign in to Twilio SendGrid. If you have no account yet, you create it yourself; verapli does not create accounts.","route":"guided","depends_on":[],"gate":"human_login","url":"https://app.sendgrid.com/login"},{"id":"start-domain-auth","title":"Start domain authentication","summary":"In Settings > Sender Authentication, click Get Started, pick your DNS host, choose whether to brand links, and enter only the root domain (no subdomain or protocol). Leave automated security on unless your DNS host rejects underscores in CNAME names.","route":"guided","depends_on":["sign-in"],"gate":"human_submit","url":"https://app.sendgrid.com/settings/sender_auth","sources":["domain-auth"]},{"id":"add-dns-records","title":"Add the SPF/DKIM DNS records and verify","summary":"Add the four records shown. With automated security on these are three CNAMEs (em####, s1._domainkey, s2._domainkey) plus a _dmarc TXT; with it off, an MX on em#### for the return path, an SPF TXT, a DKIM TXT and a _dmarc TXT. Then click Verify.","route":"guided","depends_on":["start-domain-auth"],"gate":"human_submit","lead_time":{"official":{"text":"DNS verification can take up to 48 hours after upload.","source":"domain-auth"}},"preflight":[{"rule":"dns_record_resolves","params":{"name":"s1._domainkey.{domain}","note":"DKIM selector record when automated security is on; copy exact values from the console","type":"CNAME"}}],"recovery":[{"hiccup":"Record shows as em123.example.com.example.com","fix":"Your DNS host appends the domain; enter only the host part (for example em123).","source":"domain-auth"},{"hiccup":"Only some records verify","fix":"Wait and check again, or look for a mistyped record.","source":"domain-auth"},{"hiccup":"Existing CNAME was replaced","fix":"Custom return path and link subdomain CNAMEs replace any CNAME with the same name; check existing records before adding.","source":"domain-auth"}],"sources":["domain-auth"]},{"id":"create-api-key","title":"Create a restricted API key","summary":"Create a Restricted (Custom) Access API key with Mail Send > Full Access only. Copy it at once; the console shows it only once.","route":"guided","depends_on":["sign-in"],"gate":"human_submit","url":"https://app.sendgrid.com/settings/api_keys","capture":{"env":"SENDGRID_API_KEY","kind":"api_key"},"sources":["quickstart","api-keys"]}],"outputs":[{"name":"SENDGRID_API_KEY","description":"SendGrid API key with Mail Send permission","secret":true,"example_format":"SG.…","from_step":"create-api-key"}],"terms_notes":[{"kind":"rules_say","severity":"yellow","title":"Single Sender Verification is for testing","text":"Single Sender Verification can get you started but SendGrid recommends it for testing only; production sending should use domain authentication.","source":"quickstart"}],"stripe_projects":false,"api_provisioning":{"available":"partial","notes":"API keys and sender authentication have v3 Web API endpoints, but sign-up and domain DNS changes are manual. SendGrid itself is not in the Stripe Projects catalogue (Twilio's catalogue service is twilio/email, see twilio/email).","source":"api-keys"},"detect":{"env_names":["SENDGRID_API_KEY"],"packages":["@sendgrid/mail"]}}}