SendGrid

Sync contacts to SendGrid Marketing Campaigns for email marketing. Keep your SendGrid contact lists up to date with your warehouse data.

Prerequisites

  • A SendGrid account with Marketing Campaigns enabled
  • A SendGrid API key (starts with SG.)

Authentication

SendGrid uses API Key authentication.

  1. In SendGrid, go to Settings > API Keys
  2. Create a new API key with Marketing permissions
  3. Copy the key (starts with SG.)
  4. Paste it into the API Key field in SignalSmith

Configuration

SendGrid does not require additional configuration fields beyond authentication.

Target Settings

FieldTypeRequiredDescription
List IDsTextNoComma-separated SendGrid list IDs to add contacts to. Leave blank to add to All Contacts only.

Supported Operations

Sync Modes: Upsert, Insert

Audience Sync Modes: Add, Remove, Mirror, Upsert

Features

  • Field Mapping: Yes
  • Schema Introspection: No

Required Mapping Fields

FieldDescription
emailContact email address

Default Destination Fields

email, first_name, last_name, phone_number, address_line_1, address_line_2, city, state_province_region, postal_code, country

Troubleshooting

Invalid API key format

SendGrid API keys must start with SG.. Ensure you copied the full key.

List ID not found

Find list IDs in SendGrid under Marketing > Contacts > Lists. The ID is a UUID string.

Contact not updating

SendGrid identifies contacts by email address. Ensure email addresses are valid and properly formatted.