Zapier integration

Zapier is an easy to use tool for building integrations between apps. An integration between two apps is called a Zap and is made up of a trigger and one or more actions or searches. Whenever the trigger happens in one app, Zapier will automatically perform the actions or searches in another app.

The Dynamic Content Zapier integration is built using webhooks and makes it easy to build apps that are triggered by actions in Dynamic Content.

In this example we'll walk through setting up a simple Zap to connect Dynamic Content to Slack. The example will send a Slack message when a content item is created in Dynamic Content.

Before you begin

In order to create integrations between Dynamic Content and Zapier, you will need the following:

  • A ClientID and Secret. You can request these from your Customer Success Manager. These credentials are required in order to allow Zapier access to the Dynamic Content APIs.
  • When you request your credentials you should ensure that you are allocated the permissions that your Zapier integration requires. This includes webhook permissions and access to the Dynamic Content hubs that you want to use.
  • Your credentials should also give you permission to perform the actions that will fire the webhooks used in the triggers. The currently supported triggers are: content item created, content item updated, edition created, edition scheduled, edition unscheduled and edition published.
  • An account on the Zapier website
  • You should also invite yourself to the Amplience Zapier beta program

Creating a Zap

To connect Dynamic Content with Zapier you create one or more Zaps. Zaps are used to connect apps together by specifying triggers, events that result in particular actions such as sending an email, or posting a message in Slack or any of the other actions included in the apps that Zapier supports.

To create a Zap to use Dynamic Content, log in to Zapier and click the "Make a Zap" button. You will be prompted to choose a "trigger app" and in this case choose Dynamic Content.

Choosing a trigger app in Zapier
Choosing a trigger app in Zapier

When Dynamic Content is chosen, you will then be asked to choose a trigger. A list of the available webhook events will be displayed. These correspond to particular actions such as creating a content item, scheduling an edition and updating a content item. Choose the event that you want to use as the trigger for your Zap. In this example we want an action to occur when a new content item is created.

Selecting Dynamic Content triggers
Selecting Dynamic Content triggers

Connecting to Dynamic Content

Once you've chosen the triggers, the next step is to connect your Zap to Dynamic Content.

Click Connect account to connect to Dynamic Content
Click Connect account to connect to Dynamic Content

Click the "Connect an Account" button and enter your Dynamic Content clientID and secret.

You need to enter your Dynamic Content client ID and secret to connect Zapier
You need to enter your Dynamic Content client ID and secret to connect Zapier

Each Zap is linked to a particular Dynamic Content hub. Choose the hub that you want to use and give the Zap a name. This name will be used as the label for the Dynamic Content webhook that supports this Zap.

Choose which Dynamic Content hub to use and give the Zap a name
Choose which Dynamic Content hub to use and give the Zap a name

On the next screen you'll be asked to create a content item in Dynamic Content to be used as a sample to set up this Zap. You can choose the "skip this step" button.

Choosing an action app

The next step is to choose the action that will be performed when the chosen event is triggered. In this example we'll choose Slack as the action app.

Choose the action app. In this example we'll choose Slack
Choose the action app. In this example we'll choose Slack

In the Slack setup we can enter the details of the message that will be sent when our chosen action is triggered. In an earlier step we set up the Zap action to be triggered when a content item is created. In Dynamic Content creating a content item will cause a content item created webhook event to be triggered. This webhook event will include a payload, including information such as the item name and modification date.

When setting up the Slack message details, we can include fields from the payload as part of the message text. In this case we'll just include the item's label. Of course for different triggers and actions you can choose other fields.

You can access the fields of the webhook payload to include in the Slack message
You can access the fields of the webhook payload to include in the Slack message

Make sure your Zap is enabled and you're ready to test your Zap with Dynamic Content.

Testing the Zap with Dynamic Content

Once the Zap is enabled, a webhook will be set up in Dynamic Content with the label "Zapier:" followed by the name you chose. In this example the webhook will be triggered when a content item is created. You can view the payload in the webhook request. See the Webhooks page for more details about viewing requests and responses.

A webhook is created that will be triggered when a content item is published
A webhook is created that will be triggered when a content item is published

To test out the Zap we'll create a new content item called "Summer collection". When the new item is saved the Zap will be triggered.

Creating a new content item in Dynamic Content
Creating a new content item in Dynamic Content

A message, including the name of the content item that we just created, is sent to the account we configured on Slack.

The Zap sends a message to Slack containing the content item name
The Zap sends a message to Slack containing the content item name

Webhooks

results matching ""

    No results matching ""