Send query results to SendGrid

SendGrid is Twilio’s email platform. Marketers use it to manage contact lists and send email campaigns.

Note

This destination uses the SendGrid Marketing Contacts API .

Beta

The SendGrid connector is currently in beta. Contact your Amperity representative to learn more.

The steps that are required to send email lists to SendGrid from Amperity.

  1. Build a query

  2. Add orchestration

  3. Run orchestration

Caution

This destination is available for sending query results to SendGrid after it is configured by a Datagrid Operator or your Amperity representative.

If this destination cannot be selected for orchestrations ask your Datagrid Operator or Amperity representative to configure a destination for sending query results to SendGrid.

Build query

You will need to build a query that outputs fields that can be sent to SendGrid. The following example shows how to return email addresses from the Customer 360 table:

SELECT
  email
FROM Customer_360
WHERE email IS NOT NULL

The email field is required, and email is the only field SendGrid receives. The schema also accepts an external_id field, but it is not sent to SendGrid in this phase.

Add orchestration

An orchestration defines the relationship between query results and a destination, including the destination and the frequency at which an orchestration runs.

  1. Open the Activations page, select the Orchestrations tab, and then click the Add orchestration button. This opens the Add orchestration dialog box.

  2. From the Object type dropdown, select Query.

  3. From the Object dropdown, select the query for which results is sent to SendGrid.

  4. From the Destination dropdown, select a destination that is configured for sending data to SendGrid.

  5. Verify all settings.

  6. Set the workflow to Manual. You can change this to automatic later, after verifying the end-to-end workflow.

  7. Click Save.

Run orchestration

Run the orchestration manually to validate that it works.

  1. Open the Activations page, select the Orchestrations tab, and then open the menu for the SendGrid orchestration. Select Run.

  2. The Status column for the orchestration updates to say “Waiting to start”, after which the notifications pane updates to include a notification that shows the current status.

  3. When the orchestration has run successfully, the status is updated to “Completed”.