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"
}