Prerequisites
- A SendGrid account (Free or any paid plan)
- Admin access to create API keys
Getting Your Credentials
SendGrid uses an API Key for authentication.
- Log into SendGrid
- Go to Settings > API Keys
- Click Create API Key
- Name it (e.g.,
Landed sync)
- Select Restricted Access
- Grant Read access to:
- Marketing > Contacts, Lists, Single Sends
- Suppressions > Bounces, Spam Reports, Blocks, Global Suppressions, Suppression Groups
- Click Create & View
- Copy the key (starts with
SG.)
Important: SendGrid only shows the full API key once at creation. Save it securely.
Required Permissions
| Permission | Streams |
|---|
| Marketing > Read | contacts, lists, single_sends |
| Suppressions > Read | bounces, spam_reports, blocks, global_suppressions, suppression_groups |
Configuration in Landed
| Field | Value |
|---|
| API Key | Your SendGrid API key (starts with SG.) |
Available Streams
| Stream | Description | Sync Mode |
|---|
contacts | Marketing contacts with email, name, address, custom fields | Full refresh |
lists | Contact lists with member counts | Full refresh |
single_sends | Single send campaigns with status and content | Full refresh |
bounces | Bounced email addresses with reason | Full refresh |
spam_reports | Emails reported as spam | Full refresh |
blocks | Blocked email addresses with reason | Full refresh |
global_suppressions | Globally unsubscribed email addresses | Full refresh |
suppression_groups | Unsubscribe group definitions | Full refresh |
Common Issues
| Symptom | Cause | Fix |
|---|
401 Unauthorized | Invalid API key | Verify the key starts with SG. and was copied correctly |
403 Forbidden | API key lacks required permissions | Create a new key with Read access to Marketing and Suppressions |
Rate limit exceeded | Too many API calls | Landed handles rate limiting automatically |
| Contacts export takes too long | Large contact list | SendGrid exports contacts asynchronously; Landed polls until complete (up to 10 minutes) |
Data Notes
- Contact exports are asynchronous -- SendGrid generates a file that Landed downloads
- Suppression data (bounces, spam reports, blocks) is append-only in SendGrid
- All timestamps are in UTC
Static IPs for Allowlisting
If your network configuration requires IP allowlisting:
- Production:
34.170.185.84, 35.192.90.94
- Staging:
34.171.93.34