Granting application account access

Organization administrators can grant standard users access to other Acoustic Campaign applications by using secure OAuth integration.

The application account access feature allows Organization administrators to add applications and user access for secure OAuth integration of third-party applications with Acoustic Campaign. This process generates the necessary consumer keys that are needed to facilitate integration. After creation, the administrator provides the keys to their integrator for API calls.

After an access token is obtained, it is good for approximately 4 hours after which a new token can be requested.

1. Go to Organization Settings under Settings and click to expand Application Account Access.
2. Click Add Application.
3. Enter a name for the application.
4. Enter a description.
5. Click Add.

   The Application Details screen provides the newly created Client ID and Client Secret. You can access these credentials again by clicking the application name.

6. Copy the codes into a text editor in preparation for sending to your IT integration department.
7. Click Close to return to the Application Account Access area.

   To add account access, take the following steps.

8. Click Add Account Access.
9. Select the application that you created from the Application list.
10. Select the user that you want to have access to this integration from the User Account list.

    This user can be a generic user.

11. Click Add.
12. An email is sent to the Organization administrator containing the User Refresh Token. Provide this token along with the ClientID and Secret to your IT department to send the API calls.

    Submit the API request to Acoustic Campaign.

13. Using your preferred tool for Rest API or non-Rest API submission, enter the request as shown in the following example, by using the credential generated in the previous section.
    Note: You can use Chrome store, Advanced RestAPI Client. You can use this tool for Rest APIs and XML APIs.
14. Enter the URL in the following format:

    https://apiyourpodnumber.ibm.com/oauth/token For example, https://api5.ibmmarketing.com/oauth/token, where 5 is your Pod number.

15. Select POST.
16. Click the Form tab and then click Add new values and enter the following values.

    grant_type refresh_token

    • client_id Enter the Client ID code that you received in Step 5.
    • client secret Enter the Client secret code that you received in Step 5.
    • refresh_token Enter the Refresh code that you received in Step 12.
17. Click Raw to encode the request.
18. Click Send.
19. The user interface displays the access token that is needed for the API call.