The SendGrid integration allows you to send emails directly through SendGrid when a user submits a Common Ninja form. This enables powerful email workflows, such as automated confirmations, custom messages, or notifications.
Connecting Your Form to SendGrid
Step 1: Enter the SendGrid Integration in the Editor
In the form editor, go to the Integration section from the left menu, and click on the SendGrid integration option.
Generating a SendGrid API Key
To connect, you’ll need your SendGrid API Key. Here's how to get it:
- Log into your SendGrid account: https://app.sendgrid.com
- Go to Settings > API Keys
- Click Create API Key
- Enter a name like “Common Ninja Integration”
- Under permissions, choose Full Access (or select custom permissions for security)
- Click Create & View
- Copy the generated key and save it securely — you won’t be able to view it again
Step 2: Adding Your API Key
Paste your API key into the integration field in the editor and click Connect Widget.
Step 3: Field Mapping
Once your form is connected to SendGrid, map your fields to match SendGrid’s contact properties:
Contact Lists
Choose the SendGrid contact list where new form submissions should be added.
Identifier Fields
These are required to uniquely identify each contact in SendGrid.
At least one identifier field (Email or phone_number_id) must be selected for the integration to work.
If no identifier is mapped, the form submission won’t be added to SendGrid.
Additional Fields
Map any optional form fields to SendGrid contact fields such as:
- first_name, last_name
- address_line_1, city, country
- phone_number, whatsapp, line
- And more…
Use the dropdown menus to link your form’s fields with the appropriate SendGrid fields.
Step 4: Save & Test
Click Save to apply your integration settings. Then test your form to confirm that emails are being sent correctly.
That’s it! Your form is now integrated with SendGrid and ready to send automated emails with each submission.