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.

SettingTypeExample
analytics[clicktracking]Boolean[true|false]false
{
  "analytics": {
    "clicktracking": true
    }
  }
}

IP Address / IP Pool

Specify the IP address or IP pool to send from.

SettingTypeExample
ip_or_pool_uuidString60a005c8-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.

SettingTypeExample
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.

SettingTypeExample
templatesString|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.

SettingTypeExample
unsubscribe_group_uuidStringc4a49083-8005-4f29-9a58-b4b9d7542f6d
{
  "unsubscribe_group_uuid": "65ac2025-3eec-4d10-98db-61510cceaaf9"
}

What’s Next