Active with remarks
This application needs additional settings. Please follow the documentation below to create your own connection.

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 Boost.space Integrator, 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] Note

The module dialog fields that are displayed in bold (in the Boost.space Integrator scenario, not in this documentation article) are mandatory!

Connecting SparkPost to Boost.space Integrator

To connect your SparkPost account to Boost.space Integrator you need to obtain the API Key from your SparkPost account and insert it in the Create a connection dialog in the Boost.space Integrator 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 Boost.space Integrator 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.

Connection

Establish a connection to your SparkPost account.

See the Connecting to SparkPost Webhook using Boost.space Integrator 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.

Connection

Establish a connection to your SparkPost account.

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.

Connection

Establish a connection to your SparkPost account.

Region

Select your region:

  • European Union

  • Others

URL

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

[Note] Note

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 Boost.space Integrator

  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.