The authentication topics describe how to create API users and how to log in to your account's Responsys servers.
Before you begin
Before you can log in to the Responsys Web Services API, you must create API users in Responsys, as described in the topic Creating API users in Responsys.
The URL for your account can be one of three types:
- Legacy account: If your account with Responsys is on a legacy pod, you will use a URL related to one of four pods. The topic Responsys REST API authentication endpoint URLs provides the authentication URLs for i2, i5, i8, and i9. Use the URL for the server that hosts your Responsys account.
- Global routing: If your account is globally routed, you will automatically have a unique global routing URL that will work across multiple locations. You can find this URL in Responsys in the WS End Point field under Account > Global settings > Account configuration. See Global Routing for more information.
- OAuth authentication using IDCS: Obtain authentication tokens from Oracle Identity Cloud Service (IDCS) and then use these tokens to send requests to Responsys APIs. See OAuth Authentication using IDCS for more information.
The REST API for Oracle Responsys Marketing Cloud Service reference guide provides the following information about how your client application can authenticate with the Responsys server:
- Log in with username and password describes how to authenticate by sending a username and password.
- Log in with username and certificates describes how to authenticate through server and client certificates. This process requires some configuration in Responsys as well as some additional client application code, but it provides greater security.
- Refreshing tokens describes how to refresh the authentication token used in the REST API calls. The authorization token is stateless and it expires after two hours, but you can refresh it before it expires.
If you prefer a PDF version of the REST API reference, see the Oracle Responsys REST API Developer's Guide.
The topic Responsys SOAP API Service URLs and WSDL provides the authentication URLs for i2, i5, i8, and i9, as well as the WSDL URLs. Use the URLs for the server that hosts your Responsys account.
The SOAP API also supports global routing URLs. See Global Routing for more information.
The Oracle Responsys SOAP API Developer's Guide provides details about how to create your authentication code can authenticate with the Responsys server. See the "Getting Started" and "Session Management API Calls" sections of the guide for more details.