Quickstart guide

If you're passing in a payload via the request body, it must be stringified within a JSON object. For example:

{
  "payload": "{\"a-stringified-json-payload\"}"
}

Go to detailed steps ➜

If you're passing in a payload via the request body for syncing to a target connection, your process flow will need a map shape - source data fields (for your incoming payload) should be added manually.

Go to detailed steps ➜

The initialise flow API request requires two identifiers - one for for the flow to be run and another for the specific flow version.

To find the process flow id, access the required process flow from the dashboard. You'll find the process flow id above the title at the top of the canvas:

And you'll find all process flow version ids at the bottom of process flow settings:

Go to detailed steps ➜

To obtain a Patchworks token for API authentication, send a POST request to the following URL:

https://svc-fabric.pwks.co/api/v1/login

This request must include your Patchworks login credentials in the body:

{
    "email": "[email protected]",
    "password": "mypassword123*"
}

Go to detailed steps ➜

To initialise a process flow, send a POST request to the following URL:

https://start.wearepatchworks.com/api/v1/flows/<flowID>/start/<flowVERSION>

Replacing <flowID> and <flowVERSION> with details for your required process flow noted previously, and authenticate with your Patchworks token.

Go to detailed steps ➜