About Approve
This API is used to approve a Bill or Vendor Credit. Only users that have approver permissions and are assigned to approve a Bill or Vendor Credit can call this API. If the Bill or Vendor Credit has more than one approver, the Bill.com system emails the next approver after the first approver approves it.
Approvers are assigned with SetApprovers (specific to the Bill or Vendor Credit) or ApprovalPolicyApprovers (mandatory approvers for a specific Approval Policy).
The comment
value creates a new note for the associated Bill/Vendor Credit.
Note: A user with permission to pay unapproved Bills can directly pay the Bill, regardless of the Bill's Approval Status.
Example
Request
<API_URL_EndPoint>/Approve.json
data={
"objectId" : "00n01TUPMWVLJHJUR1mg",
"entity" : "Bill",
"comment" : "Looks good to me."
}
Response
{
"response_status" : 0,
"response_message" : "Success",
"response_data" : { }
}
Resources
- Approve or deny a bill
- Approvals
- ListUserApprovals
- ApprovalPolicyApprovers
- SetApprovers
- User Roles and Permissions
Parameters
Field Name | Description | Required? |
---|---|---|
objectId | The system generated ID of the Bill or Vendor Credit that needs to be approved. | Yes |
entity |
Define the type of the entity. If the |
Yes |
comment | Description or note that the approver adds when approving the Bill or Vendor Credit. | No |