Skip to content

SparkPost

The SparkPost modules allow you to track, create, update and delete a customer event and customers in your SparkPost account.

Getting Started with SparkPost

Prerequisites

  • A SparkPost account

In order to use SparkPost with Ibexa Connect, it is necessary to have a SparkPost account. If you do not have one, you can create a SparkPost account at app.sparkpost.com/join.

Note

The module dialog fields that are displayed in bold (in the Ibexa Connect scenario, not in this documentation article) are mandatory!

Connecting SparkPost to Ibexa Connect

To connect your SparkPost account to Ibexa Connect you need to obtain the API Key from your SparkPost account and insert it in the Create a connection dialog in the Ibexa Connect module.

  1. Log in to your SparkPost account.

  2. Click Configuration > API Keys > Create API Key.

  3. Enter a name for the API Key, select the permissions, and click Create API Key.

    61f27b3ebec53.png

  4. Copy the API Key to your clipboard.

    61f27b40409bf.png

  5. Go to Ibexa Connect and open the SparkPost module's Create a connection dialog.

    61f27b419d671.gif

  6. In the Connection name field, enter a name for the connection.

  7. In the Region field, select the region of the organization:

    • European Region

    • Others

  8. In the API Key field, enter the API key copied in step 4 and click Continue.

    The connection has been established.

Triggers

Watch New Events

Triggers when a new event is processed.

Webhook Name Enter a name for the webhook.

See the Connecting to SparkPost Webhook using Ibexa Connect to add the webhook in your SparkPost account.

Actions

Send an Email

Sends an email with your SparkPost.com account. You will need an API key with at least the "Transmissions: Read/Write" permission.

From Enter the email address from which you are sending the email.
Subject Enter the subject line of the email.
Text Enter the email body message.
Recipient Add the email addresses of the recipients.

Make an API Call

Performs an arbitrary authorized API call.

Region

Select your region:

  • European Union

  • Others

URL

Enter a path relative to https://api.sparkpost.com/api. For example: /v1/transmissions

For the list of available endpoints, refer to the SparkPost API Documentation.

Method

Select the HTTP method you want to use:

GET

to retrieve information for an entry.

POST

to create a new entry.

PUT

to update/replace an existing entry.

PATCH

to make a partial entry update.

DELETE

to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - Get IP Pools

The following API call returns all IP Pools from your SparkPost account:

URL:

/v1/ip-pools

Method:

GET

61f27b446c62a.png

Matches of the search can be found in the module's Output under Bundle > Body > results.

In our example, 2 IP pools are returned:

61f27b457c1eb.png

Connecting to a SparkPost Webhook using Ibexa Connect

  1. Open the Watch Events module, enter the details as mentioned in the Watch New Events, and copy the address to your clipboard.

    61f27b4687925.png

  2. Log in to your SparkPost account. From the left menu, click Configuration > Webhooks.

    61f27b47a74f5.gif

    Webhook Name Enter a name for the webhook name.
    Target URL Enter the URL address copied in step 1.
    Events Select the option for events for which you want to receive the triggers.
    Authentication Select the Authentication method.
  3. Click Create Webhook.

    61f27b4a1cf89.png

The webhook is successfully created. Events** | Select the option for events for which you want to receive the triggers. | | Authentication | Select the Authentication method. |

  1. Click Create Webhook.

    61f27b4a1cf89.png

The webhook is successfully created.