website logo
⌘K
Introduction
Automation Editor
API Editor
BUILD GUIDE
Environments
API
Design
Webhooks
Connections
Constants
WEBHOOKS SETUP
Google Calendar Webhook
Quickbooks Webhook
Square Webhook
Twitter Webhook
Xero Webhook
CORE APIs
Core API Functions
Core Multi
Core Bulk
Text
Number
List
DateTime
JSON
Web
ACCOUNT MANAGEMENT
Manage Account
Analytics
Monitor Your Tasks
Request APIs
Request Provider
Docs powered by archbee 
32min

Design

Navigating, building and activating an automation is real simple. Everything you need to build and manage your automations is placed in the toolbar below.

This makes it easy to switch between options without leaving your primary build page.

You will always begin in your Dev environment first (click here to know more about Environments) where you will build your automation and run it before you can Push to Live.

Image: Toolbar
Image: Toolbar



Basic

Here are some basic features you need while building out your automation:

  • Call API: This is the all important option that adds a new API task to your automation. Add this to add an API call
  • If Condition: Add true/false conditions to a task and add Call API for individual condition
  • Loop: Loop through a list, either from your data or response received
  • Send a response



Document image



Video Walkthrough

See a quick video that shows how you can built your automation with APIs. The video covers 2 different use cases and implementation types (all in under 7 minutes).

Note: Our Environments is new feature and has not been updated to the video yet. Stayed tuned for our new video :)







Designing your Automation

Create a new automation or edit an existing one easily.

  • Click on Design from the toolbar and select Create New
  • You can also edit your existing automation by clicking the edit icon from the Design popup or from your Automation home page
Image: Design
Image: Design



Trigger & Endpoint

The first step is to set the Trigger (i.e. how will the automation be initiated), this is done by the Properties window of the first task.

  • Select the first task and click on the Properties tab
  • Name your automation, the trigger will always be an Endpoint
  • Click on the Schedule dropdown and choose how you would like to trigger this automation:
    • Manual: if you would like to call the endpoint from your end or use webhooks, choose this option
    • Time: scheduled run



Image: Triggering automation
Image: Triggering automation



  • If you have a sample JSON payload, you can enter it under the Call data section (note: this allows you to pick a response in the following tasks)
  • Add a Description if you'd like (for internal purpose only)
  • Click on the Endpoint to get the endpoint for your automation
Image: JSON and Endpoint
Image: JSON and Endpoint



Add API task

Add an API to make the API call through Add Action.

  • Click on Call API (or the + icon) to add a new API task to your automation
Image: Add API
Image: Add API



  • Add a Title and click on Select API
  • On Select API, search for the API (if you don't see the one you want, you can simply add it yourself with API Setup)
Image: Search API
Image: Search API



  • On selecting the API, you will need to choose the Connection to use (if there are no Connections, click on Add Connection and authorise a new Connection)
  • Complete the requested information for the API
  • You can now proceed to add multiple tasks by clicking on the + icon or the Call API button



Optional Advanced Settings

Each API task added has optional advanced settings that allow you to:

  1. Add a delay between your calls (this is especially useful if the provider API you are accessing has an API limiting in place)
  2. Run synchronously allows you to wait for the API call to finish (wait for a response from the provider) before moving on to the next API). By default this is set to Auto which automatically either waits for a response or moves on to the next API based on which API response is consumed.



Image: Advanced optional settings
Image: Advanced optional settings



Using API Data

Pathfix Automation allows you to use the data received from all your previous API calls in the current API call. This means, you can use this data in your next API call.

See example below, which shows how you can add the Xero customer data received in your Slack notification you send to your customer:

Image: API Data
Image: API Data



Test and Enable

Once you have built your automation and added the APIs you want to connect, click on the Test tab to run a test against all your API calls in the automation before you can Push to Live. This is a mandatory step.

The entire automation will execute:

Image: Test and Enable
Image: Test and Enable



Push to Live

After testing has been completed successfully on all tasks configured, you can Push your automation to Live by clicking Push to Live. Please note, you will not be able to publish an automation without running the test automation first.



Viewing Live Automation

Once you have published your automation to Live, you can switch to your Live enviroment by clicking on the environment name on the top navigation bar and selecting Live.

Document image

Here, you can:

  • View all Live automations
  • View all tasks configured in an automation
  • Copy the endpoint of the automation
  • Enable or Disable an automation

You will NOT be able to change any of the configuration of a Live automation. To make changes, you will have to switch to your Dev environment, make the change, Test it and then Push to Live.







Need help? You can always reach out to our support team for any additional assistance at support@pathfix.com.

Updated 11 Jan 2023
Did this page help you?
Yes
No
UP NEXT
Webhooks
Docs powered by archbee 
TABLE OF CONTENTS
Basic
Video Walkthrough
Designing your Automation
Trigger & Endpoint
Add API task
Optional Advanced Settings
Using API Data
Test and Enable
Push to Live
Viewing Live Automation