Creating Action Services

Create a service to power your app. Services are self-contained components of apps that are used by marketers. Creating a service is essentially registering the service you developed with the App Framework by entering your service's URL endpoints.

Learn more by watching the video

To create an Action service:

  1. From the AMS home page, select the app you want to create a service for.
  2. Click Add a Service.

  3. Enter your service details and then select Action for Service Type.

    • Service Name: Enter the name of your service. The maximum length is 256 characters.
    • Service Description: Enter a description of your service. The maximum length is 2048 characters.
    • Service Type: Select Action.

    • Service URLs: Enter your service's URLs endpoints. All URLs have a maximum length of 1024 characters unless specified otherwise. All endpoint URLs can be absolute URLs, or be relative URLs to the Base URL unless indicated otherwise. For example, if your Base URL is https://awesomeapp.com a relative Create URL would be create. When the Create URL is called, the full URL will be https://awesomeapp.com/create.

      • Base URL: URL location where your app is hosted. The Base URL is the root of your app's web hosting address that stays consistent. Must be a fully qualified URL including the https://. For example: https://awesomeapp.com.

      • Configure URL: URL endpoint for your service that is called when users configure the service. This endpoint should return HTML as an HTTP GET request.

        For more information, see Service Lifecycle.

      • Create URL: URL endpoint for your service that will be called when services are created.

        For more information, see Service Lifecycle.

      • Delete URL: URL endpoint for your service that will be called when services are deleted.

        For more information, see Service Invocation.

      • Invoke URL: URL endpoint for your service to call when your app is invoked. App invocation is the process where the App Framework communicates with your app to perform an action.

        For more information, see Service Invocation.

      • Status URL: URL endpoint to call to check the service's status.

      • Save Configuration URL: URL endpoint to call when your service's configuration is saved.

        For more information, see Service Lifecycle.

      • Max Batch Size: The maximum number of records to push per HTTP request. If the number of members exceeds the Max Batch Size, an invoke without data will occur.

        For more information, see Service Invocation.

  4. Click Continue.

  5. Select the assets your service will support.

    For Responsys:

    • Program: Enables your service to be used in a Program canvas. Action services are used in programs as program stages.
    • Dashboard: Enables your service to be used in the Dashboard.
  6. Click Continue.

  7. Enter the URL locations for your service's logos. Three sizes are required.

    Important: Your logos must be linked images. Base64 encoded data is not supported.

    • Large: Displayed in the Oracle Marketing product in the app catalog. This image is 192x192 pixels when displayed. The recommended size is 192x192 pixels. Must be absolute URL.
    • Canvas Icons (Medium): Displayed in the Oracle Marketing product when the app is dragged onto the canvas. This image is 32x32 pixels when displayed. The recommended size is 32x32 pixels. Must be absolute URL.
    • Canvas Icons (Small): Displayed in the Oracle Marketing product when selecting the app from the Program palette. This image is 16x16 pixels when displayed. The recommended size is 16x16 pixels. Must be absolute URL.

    Click Preview to ensure the images are displayed properly.

  8. Click Finish.

Your service details will be displayed. You'll be sent an email confirmation for your new service.

Learn more

Action Services

Services

Explore CX App Manager Help