You can use OAuth to authenticate the Watson Campaign Automation APIs.
Authenticating APIs with OAuth
- All Documentation
- Acoustic, L.P. Support Handbook
- Acoustic, L.P. Contract Terms
- Acoustic Content
- Acoustic Marketing Cloud
- Customer Experience Analytics
- Release Notes for UI Capture, IBM Tealeaf, and Digital Analytics SDKs
- Tealeaf UI Capture
- IBM Tealeaf UI Capture Release Notes
- Tealeaf UI Capture overview
- Best practices for UI Capture integration and configuration
- Change management for Document Object Model elements
- Configure UI Capture basic settings
- Configuring the JavaScript
- Cross-domain communication
- Gestures configuration for UI Capture
- How UI Capture for replay works
- Inactivity timeout setting
- Installation on the web server
- Installation on web pages
- JSON message type schemas and examples for UI Capture
- Privacy masking and blocking sensitive data
- RegEx Tester
- Troubleshooting
- UI Capture FAQ
- UI Capture installation and implementation
- UI Capture Public API Reference
- UI Capture reference
- UI Capture usage guidelines
- Upgrade UI Capture
- URL Normalization
- Variations between jQuery and W3c flavors of UI Capture
- Web page modifications
- Web server configuration for the UI Capture JavaScript
- Customer Experience Analytics SDK for Android, standard and mobile editions (Tealeaf)
- Troubleshooting for Android
- Android SDK Library Tealeaf Class References
- Configuration files for the Android SDK library
- How-tos with Sample Code for Android
- Hybrid applications for Android
- JSON message type schemas and examples for Android
- On premise Server-side KillSwitch sampling functions for Android
- Customer Experience Analytics SDK for iOS, standard and mobile editions (Tealeaf)
- Supported controls for iOS
- Troubleshooting for iOS
- Configuration file for the iOS SDK library
- Custom instrumentation for iOS
- Framework and logging for iOS
- How-tos with Sample Code for iOS
- Hybrid applications for iOS
- JSON message type schemas and examples for iOS
- On premise Server-side KillSwitch sampling functions for iOS
- Modifying Tealeaf events in Advanced mode
- The Digital Analytics SDK for Android
- The Digital Analytics SDK for iOS
- Campaign Automation
- TLS 1.2 Migration for Mobile Push Clients
- Campaign Automation Platform
- APIs for Managing SMS
- Authenticating APIs with OAuth
- Campaign Automation SOAP API
- REST API Methods
- Bulk Export (BEX) REST API
- Create Rich Content API
- Exporting SMS messages from the SMS Campaign Manager using a REST API
- Get a list of all active Text to Join SMS programs for an Org
- GET Contact by Lookup Key REST API
- Get Rich Content API
- How are APIs for simple mobile app push messages different from rich mobile app push message APIs?
- In-App Content API
- Push to Segment API
- Push to Segment API with inline content
- REST API for adding a column to an existing Relational Table
- REST API Response Codes
- REST API to get an SMS Program status
- REST API to get published messages from Watson Campaign Automation
- REST API to Send Transactional SMS Messages
- Update an SMS Program Attribute
- REST API SMS External Consent
- Use Cases for REST APIs
- Push to Contact API
- REST API to Send Push to Contact Source
- REST API to send SMS to Contact Source
- Use Case: BCC REST API
- Use Case: REST API to map Universal Behaviors
- Campaign Automation XML API
- API Legal information
- API Reference Guide
- Basics
- Code Samples and Responses
- Create Query Criteria
- FAQs
- Glossary
- Optimove – Acoustic Campaign Automation API integration
- Postman Collection
- Scenario: Impact of sent emails
- Scenario: Schedule a message to be sent at a specific time across time zones
- Test Harness
- Troubleshooting
- What is better, SOAP API or XML API?
- Troubleshooting SDK configuration
- JSON Payload and Valid Values for Custom Actions
- Create Interactive Notifications on iOS Applications Using Static Categories
- Marketing: Mobile App Message Developers
- Transactional Triggered Messages
- Mobile Application Messaging
- Assign new MUIDs to devices when reinstalling apps
- Automated Restores on Android
- Best practices for customizing mobile app messages
- Create an SMS Program
- Delete an SMS Program
- GDPR Support for Cordova and Xamarin
- iOS Application Badging
- Karix SMS JSON API User Guide
- Re initializing the SDK after a GDPR request for erasure
- Setting the baseURL for pods on Windows
- Configuring the Add-to-Calendar action plug-in
- Supported platforms and sample app compatibility in IBM Mobile App Messaging V3.X
- Pending and immediate events in Windows
- Where to find documentation for IBM Mobile App Messaging V3.X
- Advanced push attributes for Windows
- Accessing registration details
- Configuring log level message types for Windows apps
- Understanding user attributes
- Workflow for sending mobile app messages
- Mobile App templates
- Mobile App actions
- Mobile App messages
- Advanced universal behaviors (UB)
- Mobile App Messages iOS
- Installing the iOS SDK by using the CocoaPods dependency manager
- Mobile app messages for iOS
- Manually integrating the iOS SDK using Swift
- Detecting the iOS SDK on your app
- Integrate Swift with iOS SDK
- Manually integrating the iOS SDK using Objective-C
- Immediate and pending events for iOS
- Setting the baseURL
- Mobile App Messages Android
- Upgrading the in-app plug-in with version 3.6.5.0 of the Android SDK
- Configuring expandable notifications
- The AndroidManifest.xml file in the sample app
- Creating silent notifications for Android apps
- Detecting the SDK on your Android app
- Configuring notification preferences
- Mobile app messages for Android
- Configuring automatic plug-in detection
- Receiving mobile app messages from outside the Watson Campaign Automation
- Advanced Android push actions and action categories
- Accessing registration details
- Simple notification click events and session tracking events for Android
- Advanced Mobile App Messaging attributes for Android
- Bundling notifications in a campaign with Android
- SDK media cache control in Android
- Modifying the SDK initialization control for alternate Android integration
- Mobile App Messages Cordova
- Upgrading the Cordova plug-ins
- Advanced Mobile App Messaging attributes for Cordova
- Configuring action plug-ins for enhanced notifications
- Configuring log level message types
- Configuring action notifications in Cordova
- Configuring events in Cordova
- Customizing and testing the sample Cordova app
- Apache Cordova overview
- Mobile App Messages Xamarin
- APIs for Integration
- Troubleshooting SDK configuration
- Acoustic Exchange
- Acoustic Exchange Public API Reference
- Account-level API
- Application API: Define applications
- Application API: Define event types for features
- Application API: Define features
- Application API: Define user access
- Application API: register endpoints
- Application APIs: Define application deployments
- Endpoint API: Custom Endpoints
- Event API
- Identity management APIs
- Jobs API
- Segment API
- Tagging with Acoustic Exchange Capture and DDX
- UBX Toolkit Overview and Requirements
- Acoustic Exchange Event syndication
- Acoustic Exchange event catalog
- UBX subscription change notifications
- UBX audience sharing
- UBX identity associations
- UBX custom endpoints
- UBX public APIs to connect producers and consumers
- Acoustic Exchange Public API Reference
- Customer Experience Analytics
Good afternoon, I need to implement that in our application. We have communication with Silverpop. Is there a way to create and ClientId and application ID and user in order to test?
Hello Carlos,
Can you provide the name of your company so that I am better able to assist you?
Thank you
Jeri
Good afternoon,
What is the limitation of api using oauth authentication?
Number of requests simultaneously
Thank you
Hello,
You may find this information useful: “Watson Campaign AutomationOAuth tokens have a lifetime of 4 hours, but tokens can be refreshed after 3 hours. If you request before the start of the fourth hour, you receive the same access token that you obtained earlier. If you request after the start of the third hour, a new access token is granted. The user account is going to have two access tokens available to them to use (the first token expires in 1 hour and the second token expires in 4 hours. Request a new token after 3 hours to avoid the unexpected expiration of a single access token.” – https://developer.ibm.com/customer-engagement/docs/watson-marketing/ibm-engage-2/watson-campaign-automation-platform/using-oauth/getting-started-oauth/
as well as “By default, up to 10 concurrent requests are allowed to our API servers at any given time when using the OAuth method for authentication. OAuth Access Tokens allow calls to re-use existing tokens if they are still valid (within the 4 hour expiration window) so that a new token does not have to be generated with every call if an existing one is still valid. This will allow multiple mobile users to access data over a single token for example, when there are many simultaneous calls from a Mobile app.” – https://developer.ibm.com/customer-engagement/docs/watson-marketing/ibm-engage-2/watson-campaign-automation-platform/using-oauth/how_many_concurrent_requests/
Thank you
Jeri
What is the authorization URL to use when requesting an OAuth access token for the IBM XML API? I noticed the python sample code snippet uses http://engage.spqa1.com/oauth/token as the URL, but when we tried that with our code it wasn’t a valid URL. Our account is on Pod 8 and I know we should be using the api8.ibmmarketingcloud.com/XMLAPI endpoint, but that isn’t working with our OAuth token requests.
Good afternoon,
In my python project i need to update or add contacts.So far, I am unable to find help about doing this with REST api. There is SOAP api for same
https://developer.ibm.com/customer-engagement/docs/watson-marketing/ibm-engage-2/watson-campaign-automation-platform/soap-api/database-management-interfaces-user/
https://developer.ibm.com/customer-engagement/docs/watson-marketing/ibm-engage-2/watson-campaign-automation-platform/soap-api/list-management/
but can’t find REST api.
Thank you.
How do I create ClientId and application ID?
Hello Johnny,
Can you provide the name of your company so that I am better able to assist you?
Thank you
jeri
Good morning, could you help me with authentication our app? I have weird problem, I already have client_id/client_secret/refresh_token generated, but I’m getting “invalid_client” during connection. Could you write to me and take a look? Thank you!
Best regards
Hello Damian,
Please see this information about Getting Started with oAuth.
https://developer.ibm.com/customer-engagement/tutorials/getting-started-oauth-watson-campaign-automation/
thank you
jeri
Hi,
I’m trying to make an API call to silver pop from Talend (ETL tool) to load an already created database in silverpop using data from a CSV file (uploaded to ‘upload’ folder on the SFTP server). I have got an access token successfully using passing the client ID,client secret and refresh token. I also have a mapping document in the upload directory.
the end point URL is : “https://api8.ibmmarketingcloud.com/XMLAPI”
headers are : “Authentication : xxxxxxxxxxxxxxxxx” and “Content-Type : text/xml;charset=utf-8″ and the HTTP body is :
”
mapping.xml
Contact_Data.csv
”
I want to load the csv data into already existing database. for the above request I’m getting the below error
false
145
SP.Admin
Please let me know where im going wrong. Im stuck and have no idea how to proceed.
Thanks in advance for any input on my problem.
Hi,
Im trying to make an API call to silver pop through Talend(ETL tool) to load csv data (in upload folder) to an already created database.
I have successfully got the access_token .. this is how im making the POST
Endpoitn URL : “https://api8.ibmmarketingcloud.com/XMLAPI”
Headers : “Authentication : xxxxxndjfdhfjkdlck” and “content-type : text/xml;charset=utf-8″
body :
”
mapping.xml
Contact_Data.csv
”
but I get the below error
false
145
SP.Admin
can someone please tell me what is wrong with my request? Im stuck and can’t find a way out
Thanks in advance for any input you give me
Fault string is — ![CDATA[Session has expired or is invalid]] and the errorID is 145.
This is my post body
mapping.xml
Contact_Data.csv
Hello,
In addition to the Content-Type header, you should have an Authorization header in the form of:
Authorization: Bearer access_token_here
Thank you
Jeri
Hello,
I have reached out to our product team to get more info on this for you. I will respond once I know more.
Thank you
Jeri