Passing Unique Arguments to SendGrid Using Swiftmailer

Question

Hi I'm using the php mailer Swiftmailer to send through SendGrid using the SMTP API. We can pass unique arguments to SendGrid to help track the email. I've been successful in passing unique headers with Swiftmailer:

   $headers = $message->getHeaders();

   $headers->addTextHeader('AccountId', $accountId);

While these values are successfully injected into the header of sent email, they are not being passed back by SendGrid to my event webhook or in the control panel.

I also tried this, which didn't work either:

$headers = $message->getHeaders();

        $args = '  {
    "customerAccountNumber": "55555",
    "activationAttempt": "1",
    "New Argument 1": "New Value 1",
    "New Argument 2": "New Value 2",
    "New Argument 3": "New Value 3",
    "New Argument 4": "New Value 4"

}';
        $headers->addTextHeader('unique_args', $args);

This is probably a question for SendGrid support but since it relates to Swiftmailer I thought I'd try here first. Thanks!

Sonny · Accepted Answer · 2017-10-18T20:10:38.783

7

SendGrid expects a JSON key/value structure in the X-SMTPAPI header entry.

I have an old project using SwiftMailer 5.0.3. This is how I send category values to SendGrid:

$message->getHeaders()->addTextHeader('X-SMTPAPI', json_encode(array(
    'category' => $category,
)));

Applying that pattern to your example:

$headers = $message->getHeaders();

$args = array(
    'unique_args' => array(
        'AccountId' => $accountId,
        "customerAccountNumber" => "55555",
        "activationAttempt" => "1",
        "New Argument 1" => "New Value 1",
        "New Argument 2" => "New Value 2",
        "New Argument 3" => "New Value 3",
        "New Argument 4" => "New Value 4",
    ),
);

$headers->addTextHeader('X-SMTPAPI', json_encode($args));

edited Oct 18 '17 at 20:10

answered Oct 18 '17 at 14:40

Sonny

8,204
7
63
134

1

Thanks! This was a struggle to figure out because SendGrid suppresses the custom arguments in the actual email header. – Acyra Oct 18 '17 at 19:48
@Acyra - I've updated my answer after taking a look at the documentation. The first sentence also links to the documentation. – Sonny Oct 18 '17 at 20:11
That helped a lot! https://app.sendgrid.com/settings/mail_settings + endpoint + https://sendgrid.com/docs/for-developers/tracking-events/php-code-example/ = ton of potential. – user2662680 Mar 23 '20 at 18:24

score 2 · Answer 2 · answered Oct 18 '17 at 14:21

The method addTextHeader is for one value

$headers->addTextHeader('unique_args', $args);

You should use addParameterizedHeader method instead like this

$headers->addParameterizedHeader(
   ["customerAccountNumber" => "55555"],
   ["activationAttempt" => "1"]
);

Passing Unique Arguments to SendGrid Using Swiftmailer

2 Answers2