How to Set the SendGrid Integration

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:

1. Log into your SendGrid account: https://app.sendgrid.com
   
   
2. Go to Settings > API Keys
   
   
3. Click Create API Key
   
   
4. Enter a name like “Common Ninja Integration”
   
   
5. Under permissions, choose Full Access (or select custom permissions for security)
   
   
6. Click Create & View
   
   
7. 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.