To send a message after a user completes an event (such as a purchase), use a triggered campaign. These campaigns can be initiated on demand via an API call or through a journey.
Triggered campaigns are ideal for sending transactional messages in response to user actions, like purchases or abandoned cart reminders. They allow for personalized marketing content based on specific user behaviors.
This article explains how to activate a triggered campaign, either within Iterable or using an API call.
NOTE
To learn more about sending messages from journeys, read Sending Messages from a Journey.
# In this article
# Activating a Triggered campaign
When you create a triggered campaign and it's details are complete so it's ready to send, it's in a Ready state. While in this state, it isn't active and doesn't send to users unless you're testing it.
To begin sending a triggered campaign, you must activate it. To activate a triggered campaign, you can turn it on in Iterable, or you can use an API call to send it on demain.
Once activated, the campaign is in the Running state and can send to users with an API call or from a journey whenever a triggering event occurs.
# Activating a triggered campaign in Iterable
To activate a triggered campaign in Iterable,
Log in to Iterable as a user with the Manage and Launch Campaigns permission for the channel that the campaign uses.
Go to Messaging > Campaigns and find the campaign you want to activate. It should be in a Ready state.
Click on the campaign name go to the campaign review page
-
Click the Activate button:
Activated triggered campaigns are in the Running state, and you can send them to users.
# Activating a triggered campaign with an API call
To activate a triggered campaign with an API call, use the
POST /api/campaigns/activateTriggered
endpoint. This changes the campaign's state to Running and allows it to send
to users.
# Sending triggered campaigns
To send a triggered campaign to a user or list of users, you can use an API call or send it from a journey.
# Sending a triggered campaign from a journey
To send a triggered campaign from a journey, add a message tile to the journey and create or select the triggered campaign you want to send.
To learn more about sending messages from a journey, read Journey Setup: Message Tiles.
# Sending a triggered campaign with an API call
To send an API-triggered campaign, use these API endpoints:
POST /api/email/targetPOST /api/push/targetPOST /api/sms/targetPOST /api/inApp/targetPOST /api/webPush/target
TIP
To use these endpoints to schedule a triggered campaign for later, include a
sendAt value in your request. However, this disables Send Time Optimization
for that send.
To send an API-triggered campaign to a list of users, use this endpoint:
# Viewing scheduled sends of triggered campaigns
To view message sends scheduled by a triggered campaign, navigate to Insights > Logs > Scheduled Messages.
Use the delete buttons at the top of the page to delete scheduled sends.
# Viewing past sends of triggered campaigns
To view past sends of triggered campaigns, navigate to Insights > Logs > Sent Messages.
From here, you can see a list of sent messages, preview them, and resend them. To preview and resend, hover over the message and click the View and Resend links that appear.
WARNING
When resending a message, Iterable uses the current version of the original message's template. Since that template may have been modified, the resend may look different than the original.
# Deactivating a triggered campaign
Deactivating a campaign stops it from sending to users. This can be useful if you are finished with a campaign and don't want it to send anymore. Only campaigns in the Running state can be deactivated.
To deactivate a triggered campaign, you can turn it off in Iterable or use an API call. This changes the campaign's state to Finished and stops it from sending to users.
# Deactivating a triggered campaign in Iterable
To deactivate a triggered campaign in Iterable:
- Log in to Iterable as a user with the Manage and Launch Campaigns permission for the channel that the campaign uses.
- Go to Messaging > Campaigns,
- Find the campaign you want to deactivate, and open it
- In the campaign review page, click the Deactivate Campaign button.
# Deactivating a triggered campaign with an API call
To deactivate a triggered campaign with an API call, use the
POST /api/campaigns/deactivateTriggered
endpoint.
# Next steps
Before sending a triggered campaign, be sure to check your design. See Reviewing a Campaign Before Sending.
# Want to learn more?
For more information about some of the topics in this article, check out this Iterable Academy course. Iterable Academy is open to everyone — you don't need to be an Iterable customer!