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:
Once you've connected your account, you can run your workflow and fetch data from the API. You can change any of the code associated with this step, changing the API endpoint you'd like to retrieve data from, or modifying the results in any way.
import { axios } from "@pipedream/platform"
export default defineComponent({
props: {
zoho_books: {
type: "app",
app: "zoho_books",
}
},
async run({steps, $}) {
return await axios($, {
url: `${this.zoho_books.$auth.api_domain}/books/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
{{custom_fields.accounts_server}}/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
{{custom_fields.accounts_server}}/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