Sending a Message - Step-by-Step

Steps for creating and sending a transactional message from our platform are:

  1. Create a template using our editor
  2. Get authentication key
  3. Send

The steps 1 and 2 will only need to be done once! Follow to instructionss below.

Step 1: Create a Template

First, use our editor to create a template. Simply type a dynamic merge field (placeholder) into a template in this format:

${first_name}

Below is the editor with a very simple template:

Note the template ID (from the URL) - you will need it soon!

Step 2: Get your Authentication Key

Navigate to your Integrations page and grab your Production Authentication Key:

Step 3: Send!

Form a Curl request and add your values:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
curl -X POST -H "X-auth-key: XXXXX"
    -H "Content-type: application/json"
    -d \
    '{
        "template_id": 123,
        "reply_to": "john@example.net",
        "from": "John",
        "to": "jane@example.net",
        "subject": "First transactional message!",
        "merge_fields": {
            "first_name": "John"
            }
    }'
'https://api.expresspigeon.com/messages'

where:

  • XXXXX is your Production Authentication Key
  • 123 is an ID of your template (replace with real value)

.. and the rest of the values should be obvious!

Simply execute this code on the terminal to send a message. For simplicity you can wrap it into a script file.

Read the message

When delivered, the message will look as expected:

Next, you can proceed to full documentation on sending a single message.