Placeholders

Placeholders

Placeholders are used to inject dynamic data into the workflow.

Using a placeholder

A placeholder can be used anywhere in your actions. Just wrap the field with two curly bracies like so: {{ your_placeholder }}

Using a sensitive placeholder

Some placeholders contain sensitive data. In these cases, you can use a different format which will add an additional layer of protection to your data: {% secret_token %}

Setting a placeholder value

Input Data can come from multiple contexts: template, user, and an execution.

User Data

User's have a json field called user_data which you are free to set any user data that you want accessible to their workflows.

Template Data

When we say template, we are referring to the workflow but we do not want it to be confused with an execution. All executions created from this workflow will have the template data. If a data field is in both execution_data and template_data then the execution_data wins (more specific).

Execution Data

When executing a workflow, data can be passed in by setting execution_data which is a json object. These values are scoped to this particular execution.

Registering a placeholder

When you register a trigger, it is very helpful to state what data you except to provide to the workflow. That way, the workflow creator can know ahead of time and take advantage of those placeholders.