Skip to main content

Adobe I/O Events Component

Adobe I/O Events notifies you when changes occur. Use the Adobe I/O Events component to easily integrate events into your applications using Webhooks.

Component key: adobe-io-events · Changelog ↓

Description​

Adobe I/O Events trigger when changes to content and data on Adobe's Experience Platform occur; or when predefined rules or thresholds have been met. Use the Adobe I/O Events Component to build reactive, near real-time event-driven applications with Adobe I/O Events.

API Documentation​

This component was built using the Adobe I/O Events API.

Connections​

Adobe I/O Connection​

key: adobeIOConnection

To establish an OAuth connection for your Adobe integration, follow these steps:

  1. Visit the Adobe Developer Console projects page by navigating to https://developer.adobe.com/console/projects.

  2. Create a new project by clicking the appropriate option.

  3. Click on "Add to project" to start configuring your project.

  4. Add the "I/O Management API" to your project. This API enables access to Adobe I/O services.

  5. Select "OAuth Server-to-Server authentication" as your preferred authentication method.

  6. Generate an access token from the connected credentials section. This step will also provide you with the Client ID required for your integration.

  7. In the Project overview view, you can download the project configuration JSON file. This file contains various values such as Organization ID, Project ID, and Workspace ID, which are essential for using the actions within your integration.

With these steps, you'll have set up an OAuth connection and obtained the necessary credentials for your Adobe I/O Events Component.

InputNotesExample
Client ID

Client Identifier of your app for the Adobe I/O Connection

Client Secret

Client Secret of your app for the Adobe I/O Connection

Headers

Additional header to supply to authorization requests

Scopes

Space separated OAuth 2.0 permission scopes for the Adobe I/O Connection

adobeio_api, openid, AdobeID, read_organizations
Token URL

The OAuth 2.0 Token URL for the Adobe I/O Connection

https://ims-na1.adobelogin.com/ims/token/v3

Triggers​

Webhook​

Receive and validate webhook requests from Adobe I/O for webhooks you configure | key: adobeIoEventWebhook

Adobe I/O Events can be configured to send webhook notifications to a flow's webhook URL when changes to content and data occur on Adobe's Experience Platform, or when predefined rules or thresholds have been met.

How It Works​

This trigger uses two branches to handle the Adobe I/O Events webhook verification flow:

  • Webhook Verify branch: When a webhook is first registered, Adobe I/O sends a challenge request containing a challenge query parameter. The trigger automatically responds with the challenge value to confirm the webhook URL, and the request is routed to this branch.
  • Trigger branch: All subsequent event notifications from Adobe I/O are routed to this branch for processing.

No additional verification steps are required. The trigger handles the challenge response automatically.

Event Types​

Adobe I/O Events supports a wide range of event types depending on the Adobe product and event provider configured. Refer to the Adobe I/O Events documentation for the complete and up-to-date list of available event providers and event types.

Returned Data​

The trigger returns the full webhook payload as received from Adobe I/O Events. The structure of the payload varies depending on the event provider and event type configured in the Adobe Developer Console.

Notes​

  • The webhook URL from the flow must be registered in the Adobe Developer Console as part of an Event Registration.
  • The challenge verification is handled automatically on the first request. Ensure the instance is deployed before registering the webhook URL with Adobe.

Data Sources​

Select Provider​

Select an Adobe I/O Events Provider from those available in your organization. | key: selectProvider | type: picklist

InputNotesExample
Connection
Consumer Organization ID

Your consumer organization Id

{
  "result": [
    {
      "label": "Example Provider",
      "key": "example-provider-id-123"
    }
  ]
}

Select Registration​

Select an Adobe I/O Events Registration from those available in your workspace. | key: selectRegistration | type: picklist

InputNotesExample
Connection
Consumer Organization ID

Your consumer organization Id

Project ID

The project Id

Workspace ID

The workspace Id

{
  "result": [
    {
      "label": "Example Registration",
      "key": "example-registration-id-123"
    }
  ]
}

Actions​

Create Events Provider​

Create an Adobe I/O Events Provider | key: createEventsProvider

InputNotesExample
Connection
Consumer Organization ID

Your consumer organization Id

Provider Description

The description of this Events Provider, as shown on the Adobe Developer Console

Provider Documentation URL

The documentation url of this Events Provider, as shown on the Adobe Developer Console

Provider Label

The label of this Events Provider, as shown on the Adobe Developer Console

Project ID

The project Id

Workspace ID

The workspace Id

{
  "data": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "label": "New Events Provider",
    "description": "A newly created events provider",
    "source": "urn:uuid:b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "docs_url": "https://developer.adobe.com/events/docs/",
    "publisher": "Adobe Custom",
    "_embedded": {
      "eventmetadata": []
    },
    "_links": {
      "self": {
        "href": "https://api.adobe.io/events/providers/b2c3d4e5-f6a7-8901-bcde-f12345678901"
      }
    }
  }
}

Create Webhook/Journal Registration​

Create a Webhook/Journal registration for given workspace | key: createWebhook

InputNotesExample
Connection
Consumer Organization ID

Your consumer organization Id

Delivery Type

The delivery type of this registration.

webhook
Registration Description

The description of this registration

Enabled

Enable or disable the registration

true
Events of Interest

The events of interest for this registration. You can get the provider_id (provider not required) and event_code from the list of registrations available for your workspace by using the List All Registrations action.

Registration Name

The name of the webhook registration which will be displayed on Developer Console

Project ID

The project Id

Runtime Action

Runtime action to be invoked by the published events

Webhook URL

The URL where the events will be delivered

Workspace ID

The workspace Id

{
  "data": {
    "id": 12345,
    "name": "My Webhook Registration",
    "description": "Receives events via webhook for custom processing",
    "client_id": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
    "registration_id": "c3d4e5f6-a7b8-9012-cdef-234567890123",
    "events_of_interest": [
      {
        "event_code": "com.adobe.custom.event.started",
        "provider": "My Custom Events Provider",
        "provider_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "event_label": "Custom Event Started",
        "event_description": "Triggered when a custom event starts",
        "provider_label": "My Custom Events Provider",
        "provider_description": "Provides custom application events",
        "event_delivery_format": "cloud_events_v1"
      }
    ],
    "webhook_status": "verified",
    "created_date": "2026-01-15T10:30:00.000Z",
    "updated_date": "2026-01-15T10:30:00.000Z",
    "consumer_id": "0A1B2C3D4E5F67890ABC@AdobeOrg",
    "project_id": "d4e5f6a7b8c90123",
    "workspace_id": "e5f6a7b8c9012345",
    "webhook_url": "https://hooks.example.com/adobe-events",
    "delivery_type": "webhook",
    "enabled": true,
    "_links": {
      "rel:events": {
        "href": "https://api.adobe.io/events/organizations/0A1B2C3D4E5F67890ABC@AdobeOrg/integrations/12345/c3d4e5f6-a7b8-9012-cdef-234567890123"
      },
      "rel:trace": {
        "href": "https://api.adobe.io/events/organizations/0A1B2C3D4E5F67890ABC@AdobeOrg/integrations/12345/c3d4e5f6-a7b8-9012-cdef-234567890123/tracing"
      },
      "self": {
        "href": "https://api.adobe.io/events/0A1B2C3D4E5F67890ABC@AdobeOrg/d4e5f6a7b8c90123/e5f6a7b8c9012345/registrations/c3d4e5f6-a7b8-9012-cdef-234567890123"
      }
    }
  }
}

Delete Events Provider​

Delete an Adobe I/O Events Provider by ID | key: deleteEventsProvider

InputNotesExample
Connection
Consumer Organization ID

Your consumer organization Id

Project ID

The project Id

Provider ID

The requested provider Id

Workspace ID

The workspace Id

{
  "data": null
}

Delete Instanced Webhooks​

Delete all Adobe I/O Webhook Registrations entitled to the provided Workspace ID | key: deleteInstancedWebhooks

InputNotesExample
Connection
Consumer Organization ID

Your consumer organization Id

Project ID

The project Id

Workspace ID

The workspace Id

{
  "data": [
    {
      "message": "Registration c3d4e5f6-a7b8-9012-cdef-234567890123 was successfully deleted."
    },
    {
      "message": "Registration d4e5f6a7-b8c9-0123-def4-567890123456 was successfully deleted."
    }
  ]
}

Delete Registration (Webhook/Journal)​

Delete Registration by Registration ID (Webhook/Journal) | key: deleteRegistration

InputNotesExample
Connection
Consumer Organization ID

Your consumer organization Id

Project ID

The project Id

Registration ID

The registration Id associated with the registration

Workspace ID

The workspace Id

{
  "data": null
}

Get Events Provider​

View Adobe I/O Events Provider by ID | key: getEventsProvider

InputNotesExample
Connection
Event Metadata

The optional boolean to fetch or not this provider's event metadata

false
Provider ID

The requested provider Id

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "label": "My Custom Events Provider",
    "description": "Provides custom application events",
    "source": "urn:uuid:a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "docs_url": "https://developer.adobe.com/events/docs/",
    "publisher": "Adobe Custom",
    "_embedded": {
      "eventmetadata": [
        {
          "event_code": "com.adobe.custom.event.started",
          "label": "Custom Event Started",
          "description": "Triggered when a custom event starts"
        }
      ]
    },
    "_links": {
      "self": {
        "href": "https://api.adobe.io/events/providers/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
      }
    }
  }
}

List All Registrations​

List all Adobe I/O Events Registrations entitled to the provided Workspace ID | key: listAllRegistrations

InputNotesExample
Connection
Consumer Organization ID

Your consumer organization Id

Project ID

The project Id

Workspace ID

The workspace Id

{
  "data": {
    "_embedded": {
      "registrations": [
        {
          "_links": {
            "rel:events": {
              "href": "https://api.adobe.io/events/organizations/0A1B2C3D4E5F67890ABC@AdobeOrg/integrations/12345/c3d4e5f6-a7b8-9012-cdef-234567890123"
            },
            "rel:trace": {
              "href": "https://api.adobe.io/events/organizations/0A1B2C3D4E5F67890ABC@AdobeOrg/integrations/12345/c3d4e5f6-a7b8-9012-cdef-234567890123/tracing"
            },
            "self": {
              "href": "https://api.adobe.io/events/0A1B2C3D4E5F67890ABC@AdobeOrg/d4e5f6a7b8c90123/e5f6a7b8c9012345/registrations/c3d4e5f6-a7b8-9012-cdef-234567890123"
            }
          },
          "id": 12345,
          "name": "My Webhook Registration",
          "description": "Receives events via webhook for custom processing",
          "client_id": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
          "registration_id": "c3d4e5f6-a7b8-9012-cdef-234567890123",
          "events_of_interest": [
            {
              "event_code": "com.adobe.custom.event.started",
              "provider_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
              "event_label": "Custom Event Started",
              "event_description": "Triggered when a custom event starts",
              "provider_label": "My Custom Events Provider",
              "provider_description": "Provides custom application events",
              "event_delivery_format": "cloud_events_v1",
              "provider_metadata": "3rd_party_custom_events"
            }
          ],
          "webhook_status": "verified",
          "created_date": "2026-01-15T10:30:00.000Z",
          "updated_date": "2026-01-15T10:30:00.000Z",
          "consumer_id": "0A1B2C3D4E5F67890ABC@AdobeOrg",
          "project_id": "d4e5f6a7b8c90123",
          "workspace_id": "e5f6a7b8c9012345",
          "webhook_url": "https://hooks.example.com/adobe-events",
          "delivery_type": "webhook",
          "enabled": true
        }
      ]
    },
    "_links": {
      "self": {
        "href": "https://api.adobe.io/events/0A1B2C3D4E5F67890ABC@AdobeOrg/d4e5f6a7b8c90123/e5f6a7b8c9012345/registrations"
      }
    }
  }
}

List Events Providers​

List all Adobe I/O Events Providers entitled to the provided Organization ID | key: listEventsProviders

InputNotesExample
Connection
Consumer Organization ID

Your consumer organization Id

{
  "data": {
    "_embedded": {
      "providers": [
        {
          "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "label": "My Custom Events Provider",
          "description": "Provides custom application events",
          "source": "urn:uuid:a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "docs_url": "https://developer.adobe.com/events/docs/",
          "publisher": "Adobe Custom",
          "_embedded": {
            "eventmetadata": [
              {
                "event_code": "com.adobe.custom.event.started",
                "label": "Custom Event Started",
                "description": "Triggered when a custom event starts",
                "_links": {}
              }
            ]
          },
          "_links": {
            "self": {
              "href": "https://api.adobe.io/events/providers/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
            }
          }
        }
      ]
    },
    "_links": {
      "self": {
        "href": "https://api.adobe.io/events/0A1B2C3D4E5F67890ABC@AdobeOrg/providers"
      }
    }
  }
}

Raw Request​

Send raw HTTP request to Adobe I/O Events | key: rawRequest

InputNotesExample
Connection
Data

The HTTP body payload to send to the URL.

{"exampleKey": "Example Data"}
File Data

File Data to be sent as a multipart form upload.

[{key: "example.txt", value: "My File Contents"}]
File Data File Names

File names to apply to the file data inputs. Keys must match the file data keys above.

Form Data

The Form Data to be sent as a multipart form upload.

[{"key": "Example Key", "value": new Buffer("Hello World")}]
Header

A list of headers to send with the request.

User-Agent: curl/7.64.1
Max Retry Count

The maximum number of retries to attempt. Specify 0 for no retries.

0
Method

The HTTP method to use.

Query Parameter

A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.

Response Type

The type of data you expect in the response. You can request json, text, or binary data.

json
Retry On All Errors

If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.

false
Retry Delay (ms)

The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.

0
Timeout

The maximum time that a client will await a response to its request

2000
URL

Input the path only (/{consumer_org_id}/providers), The base URL is already included (https://api.adobe.io/events), Authorization and x-api-key headers are already included. For example, to connect to https://api.adobe.io/events/{consumer_org_id}/providers, only /{consumer_org_id}/providers is entered in this field.

/{consumer_org_id}/providers
Use Exponential Backoff

Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.

false

{
  "data": {
    "status": 200,
    "headers": {},
    "body": {
      "_embedded": {
        "providers": [
          {
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "label": "My Custom Events Provider",
            "description": "Provides custom application events",
            "source": "urn:uuid:a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "publisher": "Adobe Custom"
          }
        ]
      },
      "_links": {
        "self": {
          "href": "https://api.adobe.io/events/0A1B2C3D4E5F67890ABC@AdobeOrg/providers"
        }
      }
    }
  }
}

Update Events Provider​

Update an Adobe I/O Events Provider | key: updateEventsProvider

InputNotesExample
Connection
Consumer Organization ID

Your consumer organization Id

Provider Description

The description of this Events Provider, as shown on the Adobe Developer Console

Provider Documentation URL

The documentation url of this Events Provider, as shown on the Adobe Developer Console

Provider Label

The label of this Events Provider, as shown on the Adobe Developer Console

Project ID

The project Id

Provider ID

The requested provider Id

Workspace ID

The workspace Id

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "label": "Updated Events Provider",
    "description": "An updated events provider description",
    "source": "urn:uuid:a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "docs_url": "https://developer.adobe.com/events/docs/guides/",
    "publisher": "Adobe Custom",
    "_embedded": {
      "eventmetadata": [
        {
          "event_code": "com.adobe.custom.event.started",
          "label": "Custom Event Started",
          "description": "Triggered when a custom event starts"
        }
      ]
    },
    "_links": {
      "self": {
        "href": "https://api.adobe.io/events/providers/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
      }
    }
  }
}

Changelog​

2026-04-10​

Updated example payloads

2026-04-07​

Added global debug support across all actions for improved troubleshooting

2026-03-05​

Added inline data sources for providers and registrations to enable dropdown selection in actions