Approveit Guide: Inbound Approveit API
Description:
Inbound API allows you to trigger approval requests with the request data from an external source
Example:
Upon filling the Google Form an approval request is initiated
How to set up:
You can activate/view your Approveit API in the Setting Section
![](https://approveit.today/wp-content/uploads/2023/11/pic_1-3.png)
To activate the Inbound Approveit API for a particular workflow:
Select Custom Form -> Next
![](https://approveit.today/wp-content/uploads/2023/11/pic_2-3.png)
![](https://approveit.today/wp-content/uploads/2023/11/pic_3-3.png)
API Request example
POST https://api.approveit.today/api/v1/approval-requests
"headers":{1 item
"Authorization":string"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUz…"
}
You can add as many fields as you need in the custom form of the workflow builder to map the incoming data from the external source to the data fields in Approveit
{2 items
"workflow_slug":string"here will be a slug after you save the workflow"
"data":{4 items
"1387_2c92b6c1-0094-49bf-8067-e464d6e725f2":{3 items
Adding a Supplier field in the workflow builder will result in the following:
"id":string"1387_2c92b6c1-0094-49bf-8067-e464d6e725f2"
"label":string"Supplier"
"value":string"value"
}
Adding a Product/Service field in the workflow builder will result in the following:
"id":string"1387_9ac94f7e-2728-4c3f-b45e-98c06803ac03"
"label":string"Product/service"
"value":string"value"
}
Adding a Gross amount field in the workflow builder will result in the following:
"1387_48209589-9a3d-4958-8f2a-eb9a5e158558":{3 items
"id":string"1387_48209589-9a3d-4958-8f2a-eb9a5e158558"
"label":string"Gross amount"
"value":int5450
}
Adding a Tax rate field in the workflow builder will result in the following:
"1387_b38fae99-24e9-44ad-a75c-256b1b68caa1":{3 items
"id":string"1387_b38fae99-24e9-44ad-a75c-256b1b68caa1"
"label":string"Tax rate"
"value":string"option"
}
}
}
- For the Amount type of field 1.00=100 in JSON
- You can not map the following types of fields: file, multifiles, vendors