---
title: Configuring a custom action
slug: flutter-crm-pillar/configuring-a-custom-action
docTags: 
createdAt: 2024-01-30T23:03:21.354Z
---

:::hint{type="info"}
To log into the Adobe Experience Platform, and open Adobe Journey Optimizer, check the **Welcome! **section.
:::

In this exercise you'll create the action to retrieve the upcoming sport event details. The data returned by the API will be used in the journey for personalisation.

## Custom action overview

**What is an Custom Action?**

Custom actions enable you to configure connection of a third-party system to send messages or make API calls to gather data. An action can be configured with any service from any provider that can be called through a REST API with a JSON-formatted payload.. [Learn more](https://experienceleague.adobe.com/en/docs/journey-optimizer/using/configure-journeys/action-journeys/action)

To get an overview of a custom actions in Adobe Journey Optimizer:

1. In the menu on the left side, under **Administration**, click on **Configurations**. You will see a set of tiles. 
2. Click on **Manage** in the **Actions** tile, to get an overview with all existing actions.

## Configuring a custom action for getting upcoming events for a particular sport

We'll be configuring a custom action that we can use in our journey. The action is to make an API call, passing the `sportID`, to retrieve upcoming relevant sport games information.

:::hint{type="warning"}
If you do not want to configure your own action, you can reuse an action that has aleady been created for you, **getUpcomingEvents**. 

Feel free to skip this exercise and proceed to [Creating the journey](docId\:ctkVrGbBKyl5UBqS3-FPe) .
:::

To configure a new action, click **Create Action**. A menu will open on the right side.

- Set the **name** to  `yourname_getUpcomingEvents`.
- For **Action type**, set the value to `Custom`.
- Leave **Access and privacy configuration** as it is.
- For **Endpoint configuration**, set **URL** with:
  1. `https://us-central1-mock-apis-cf3a1.cloudfunctions.net/api/betting/events/`
- Set **Method** with **GET**.
- Keep the **headers** as it is.
- Keep Authentication as **No authentication.**
- Scroll down to **Payloads**, and click on `0 fields selected`, a popup will be opened. This is the place where you can specify the response payload expected from the endpoint.
- Copy this JSON and paste into the popup:

:::BlockQuote
\{
  "success": true,
  "data": \[
    \{
      "eventId": "fAEvO",
      "eventName": "Gold Cup",
      "competitionName": "Cheltenham",
      "openDateTime": "09/05/2025 07:54"
    }
  ]
}
:::

The UI will automatically identify the name and type of the fields.

- Click **Save**.
- The window will close and you should now see `5 fields selected`.
- Your screen should look like the image below. Scroll up and click **Save**.

![](https://api.archbee.com/api/optimize/6H6rknlvdVrktAepVnpsA-mz_JPGUHDeXyYF_nyL2Cj-20250509-093505.png)

:::hint{type="success"}
You have successfully created an **Action** to be used in our journey! 
:::