X-SMTPAPI Header
You can customize the emails you send via SMTP by using different settings that are defined in the X-SMTPAPI header. The value of this header must be JSON. These filters will override any default settings you have in the "General" page under the Mail Settings tab.
Analytics
The analytics setting allows you to control clicktracking for the email.
Setting | Type | Example |
---|---|---|
analytics[clicktracking] | Boolean[true|false] | false |
{
"analytics": {
"clicktracking": true
}
}
}
IP Address / IP Pool
Specify the IP address or IP pool to send from.
Setting | Type | Example |
---|---|---|
ip_or_pool_uuid | String | 60a005c8-37f2-4751-a83e-7440bafe7dc8 |
{
"ip_or_pool_uuid": "60a005c8-37f2-4751-a83e-7440bafe7dc8"
}
Substitutions
Substitutions let you create dynamic content for your email. Up to 1,000 substitutions can be processed. In general, we recommend using dynamic template variables over substitutions.
Setting | Type | Example |
---|---|---|
filters[substitutions] | Array[Object] | [{ "-first_name-": "John" }] |
{
"substitutions":[{"-first_name-": "John" }]
}
Templates
The templates setting allows you to associate a template with an email.
The value can either by the UUID of the template you want to use, an array of template UUID's (which will be randomly picked with equal weight), or an array of objects whose keys are template UUIDs and values are weights (on a scale of 0 to 1). This allows you to do A/B/C/... testing with templates.
Setting | Type | Example |
---|---|---|
templates | String|Array[Object] | { "d5acb025-aeec-4810-98db-61510cce6af9": 0.6, "2dea6e03-6fdc-4302-9102-61b6c278a9a9": 0.4 } |
{
"template": "d5acb025-aeec-4810-98db-61510cce6af9"
}
Unsubscribe Groups
The unsubscribe group setting allows you to associate an unsubscribe group with an email. If enabled, Amply will include the List-Unsubscribe header, as well as replace all unsubscribe link/url special variables in the email body.
Setting | Type | Example |
---|---|---|
unsubscribe_group_uuid | String | c4a49083-8005-4f29-9a58-b4b9d7542f6d |
{
"unsubscribe_group_uuid": "65ac2025-3eec-4d10-98db-61510cceaaf9"
}
Updated about 1 month ago