Adding SMTP Connections

SMTP connections are how Score CRM sends emails. You need at least one configured connection before you can launch any campaigns or journeys.
Creating a Connection
- Navigate to SMTP in the sidebar
- Click Add Connection
- Fill in the connection details:

Connection Fields
| Field | Required | Description |
|---|---|---|
| Name | Yes | A descriptive name (e.g., "SendGrid Production") |
| Vendor Type | Yes | The email provider type |
| Host | Yes* | SMTP server hostname |
| Port | Yes* | SMTP server port (usually 587 or 465) |
| Username | Yes* | SMTP authentication username |
| Password | Yes* | SMTP authentication password |
| API Key | Yes* | API key for API-based providers (SendGrid, SparkPost, SMTP.com) |
| Secure | No | Enable TLS/SSL (recommended) |
| From Email | No | Default sender email for this connection |
| From Name | No | Default sender name for this connection |
*Required fields depend on the vendor type. API-based providers need an API key instead of host/port/username/password.
Security
All sensitive credentials (passwords, API keys, webhook signing keys) are encrypted using AES-256-CBC encryption before being stored. They are never stored in plain text.
- Click Save
Webhook Configuration
For providers that support webhooks (event tracking), Score CRM automatically generates a webhook URL for each connection:
https://your-domain.com/webhooks/v2/{vendor}/{connectionId}
You'll need to configure this URL in your email provider's webhook settings. See Webhook Setup for provider-specific instructions.
Default Sender Settings
When you set From Email and From Name on an SMTP connection, these values are automatically pre-populated in the campaign builder when you select that connection. This saves time and ensures consistency.
Connection Status
After saving, your connection is ready to use. You can verify it's working with the test connection feature.
Managing Connections
| Action | Description |
|---|---|
| Edit | Update connection settings (credentials, sender info) |
| Delete | Remove the connection (cannot delete if used by active campaigns) |
| Test | Send a test email to verify the connection works |
Deleting an SMTP connection that is referenced by running or scheduled campaigns will cause those campaigns to fail. Always ensure no active campaigns are using a connection before deleting it.