Events trigger workflow executions. The event that triggers your workflow depends on the trigger you select for your workflow:
- HTTP triggers invoke your workflow on HTTP requests.
- Cron triggers invoke your workflow on a time schedule (e.g., on an interval).
- Email triggers invoke your workflow on inbound emails.
- Event sources invoke your workflow on events from apps like Twitter, Google Calendar, and more.
# Selecting a test event
When you test any step in your workflow, Pipedream passes the test event you select in the trigger step:
You can select any event you've previously sent to your trigger as your test event, or send a new one.
# Examining event data
When you select an event, you'll see the incoming event data and the event context for that event:
Pipedream parses your incoming data and exposes it in the variable
steps.trigger.event, which you can access in any workflow step.
# Copying references to event data
When you're examining event data, you'll commonly want to copy the name of the variable that points to the data you need to reference in another step.
Hover over the property whose data you want to reference, and click the Copy Path button to its right:
# Copying the values of event data
You can also copy the value of specific properties of your event data. Hover over the property whose data you want to copy, and click the Copy Value button to its right:
# Event format
When you send an event to your workflow, Pipedream takes the trigger data — for example, the HTTP payload, headers, etc. — and adds our own Pipedream metadata to it.
This data is exposed in the
steps.trigger.event variable. You can reference this variable in any step of your workflow.
You can reference your event data in any code or action step. See those docs or the general docs on passing data between steps for more information.
The specific shape of
steps.trigger.event depends on the trigger type:
| ||A string or object representation of the HTTP payload|
| ||IP address of the client that made the request|
| ||HTTP headers, represented as an object|
| ||HTTP method|
| ||HTTP request path|
| ||Query string|
| ||Request host + path|
# Cron Scheduler
| ||The number of seconds between scheduled executions|
| ||When you've configured a custom cron schedule, the cron string|
| ||The epoch timestamp when the workflow ran|
| ||An object with formatted datetime data for the given execution, tied to the schedule's timezone|
| ||An object with formatted datetime data for the given execution, tied to the UTC timezone|
We use Amazon SES to receive emails for the email trigger. You can find the shape of the event in the SES docs (opens new window).
steps.trigger.event contain your event's data.
steps.trigger.context contains metadata about the workflow and the execution tied to this event.
You can use the data in
steps.trigger.context to uniquely identify the Pipedream event ID, the timestamp at which the event invoked the workflow, and more:
| ||A globally-unique string representing the current version of the workflow|
| ||A unique, Pipedream-provided identifier for the event that triggered this workflow|
| ||The Pipedream-assigned user ID for the owner of the workflow|
| ||The version of the Pipedream execution environment this event ran on|
| ||The ISO 8601 timestamp at which the event invoked the workflow|
| ||The workflow ID|
| ||The workflow name|
You may notice other properties in
context. These are used internally by Pipedream, and are subject to change.
# Limits on events queue
On the Free and Basic plans, only the last 100 events are retained for each workflow. After 100 events have been processed, Pipedream will delete the oldest event data as new events arrive, keeping only the last 100 events.
The Advanced and Business tiers have an upgraded amount of events in the queue, please see the pricing page (opens new window) for more details.
For an extended history of events across all of your workflows, included processed events, with the ability to filter by status and time range, please see the Event History.