Create a trigger in Studio
- Open the workflow in Studio and select Triggers in the top bar.
- Select Add, then map any workflow inputs to fields in the request body.
- Save the endpoint URL and signing secret. The URL stays available in the trigger’s Setup tab; the secret is shown only when the trigger is created or its secret is rotated.
Map the event body
Mappings use JSON Pointer (RFC 6901). Each workflow input maps to a pointer into the incoming JSON object. For example, for this body:order_id to /order/id and customer_email to /order/customer/email. Pointers must start with /; in a key name, encode ~ as ~0 and / as ~1.
Send a signed request
Send aPOST to the endpoint URL from Studio with these headers:
Calculate the HMAC with the UTF-8 bytes of the trigger secret as the key. Sign the exact raw request body bytes, prefixed with the UTF-8 bytes of
v1:{timestamp}:{event_id}::
Responses and retries
If a request times out or you do not receive a response, retry with the same event ID and exact same body. This lets Skyvern return the existing delivery instead of creating a second one. Refresh the timestamp and signature on every attempt. Do not retry a
422 unchanged; use Studio replay after correcting the mapping.

