Overview
Knak has a direct integration with Responsys. Use it to sync email assets from Knak to Responsys.
Create A Knak User In Responsys
Create a dedicated user in Responsys for the integration.
You need the following details:
Username
Password
Knak stores the password in an encrypted database. This keeps it separate from the rest of your data.
Required Responsys Roles
Assign these roles to the integration user under the Role Assignment tab:
Role | Purpose |
Campaign Web Services Manager | Allows campaign access through web services |
Content Web Services Manager | Allows content access through web services |
Folder Web Services Manager | Allows folder access through web services |
š” Tip: Use an email alias when setting up integrations (for example, youremail+api@domain.com).
This keeps all integrations tied to one dedicated account. It also prevents disruptions if a team member leaves.
Oracle Responsys API Access Request Requirements
When requesting Advanced API access from Oracle, you may be asked to provide the following information:
Business use case and API functions
Explain that you want to create Responsys campaigns from Knak.
Mention that Knak creates emails and sends them to Responsys through the API.
Advanced API functions
Create Email Campaign
Update Email Campaign Properties
Copy Email Campaign
Current peak call volume
Enter the number of emails you expect to sync each day when you begin using Knak.
Projected peak call volume
Enter the number of emails you expect to sync each day after your team fully adopts Knak.
Create The Integration In Knak
Click Admin in the top-left corner.
Go to Integrations.
Click Platforms.
Find the Responsys tile under All Platforms.
Click Connect.
Enter the following information:
Integration Name
API Username
Password
Responsys Environment URL
Click Create New Integration.
Your Responsys Environment URL may use one of the following formats:
Oracle Cloud Infrastructure (OCI):
marketing-us.responsys.ocs.oraclecloud.comLegacy Responsys:
interact2.responsys.net
The Responsys Environment URL is the address you use to sign in to Responsys. Knak automatically includes https://, so do not enter it in this field.
Manage Your Integration
After setup, view your integration in the My Platform Connection list on the Integrations page.
From here, you can:
View the configuration
Edit the integration
Delete the integration
To connect a new integration or re-add a deleted one:
Scroll to All Platforms.
Find the Responsys tile.
Click Connect or Add Another Connection.
Sync Emails From Knak To Responsys
Before you sync your email, complete the required setup in Responsys.
Prepare the Campaign in Responsys
Choose the folder where you want to sync the email.
Create a campaign.
Go to Campaigns > Manage Campaigns > Create Campaign.
Enter a campaign name.
Select the campaign purpose.
Open the campaign.
Select a profile list.
Important: A profile list is required. The sync will fail if no profile list is selected.
Sync the Email from Knak
Open your email in Knak.
Click Actions > Sync.
Select your Responsys integration.
Choose one of the following sync options:
Auto-generate a new table to create a new link table for the campaign.
Do not alter the link table to keep the existing link table.
Click Confirm & Sync.
Important: The From Email Address in your Knak email must match an email address configured in your Responsys account. If it does not, the email cannot be synced.
Responsys Sync Limitations
When you sync an email from Knak to Responsys, the following Responsys features are not supported:
Conditionals (
#if)Includes (
#include)
Add conditionals and includes directly in Responsys after the email has been synced.
Resync an Email
After you resync an email:
Open the email preview in Responsys.
Hover over the preview.
Click Edit Message.
Click Save.
The updated email appears in the campaign preview.
Need more help? Contact support via live chat within Knak using the chat bubble in the bottom right corner or email support@knak.com.