Zoho Books is an online accounting software that helps you manage your finances, get paid faster, and work collaboratively with your clients and teams. The Zoho Books API provides a wide variety of integration possibilities to connect with your accounting software and build powerful, efficient applications. With the API, you can quickly and easily add functionality that simplifies your complex tasks, such as invoicing, payments, bank reconciliation, reporting, and more.
Below are some of the features, tasks, and applications that can be built using the Zoho Books API:
import { axios } from "@pipedream/platform"
export default defineComponent({
props: {
zoho_books: {
type: "app",
app: "zoho_books",
}
},
async run({steps, $}) {
return await axios($, {
url: `https://books.${this.zoho_books.$auth.base_api_uri}/api/v3/users/me`,
headers: {
"Authorization": `Zoho-oauthtoken ${this.zoho_books.$auth.oauth_access_token}`,
},
params: {
organization_id: `${this.zoho_books.$auth.organization_id}`,
},
})
},
})
Zoho Books uses OAuth authentication. When you connect your Zoho Books account, Pipedream will open a popup window where you can sign into Zoho Books and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Zoho Books API.
Pipedream requests the following authorization scopes when you connect your account:
ZohoBooks.fullaccess.all
GET
https://accounts.{{custom_fields.base_api_uri}}/oauth/v2/auth
?
client_id={{oauth.client_id}}
&
redirect_uri={{oauth.redirect_uri}}
&
state={{oauth.state}}
&
response_type=code
&
scope={{oauth.space_separated_scopes}}
&
prompt=consent
&
access_type=offline
POST
https://accounts.{{custom_fields.base_api_uri}}/oauth/v2/token
content-type: application/x-www-form-urlencoded
accept: application/json
client_id={{oauth.client_id}}
&
client_secret={{oauth.client_secret}}
&
redirect_uri={{oauth.redirect_uri}}
&
grant_type=authorization_code
&
code={{oauth.code}}
POST
https://accounts.{{custom_fields.base_api_uri}}/oauth/v2/token
?
client_id={{oauth.client_id}}
&
client_secret={{oauth.client_secret}}
&
grant_type=refresh_token
&
refresh_token={{oauth.refresh_token}}
&
redirect_uri={{oauth.redirect_uri}}
content-type: application/x-www-form-urlencoded
accept: application/json