Zoho Books

Online accounting software

Go to site
Explore
/
Apps
/
Zoho Books

Zoho Books API Integrations

Build and run workflows using the Zoho Books API. Use 1000s of open source triggers and actions across 800+ apps. Or write custom code to integrate any app or API in seconds.

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}`,
      },
    })
  },
})

Authentication

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
OAuth Request Configurations:
  1. authorization
    GEThttps://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
  2. accessToken
    POSThttps://accounts.{{custom_fields.base_api_uri}}/oauth/v2/tokencontent-type: application/x-www-form-urlencodedaccept: application/json
    client_id={{oauth.client_id}}&client_secret={{oauth.client_secret}}&redirect_uri={{oauth.redirect_uri}}&grant_type=authorization_code&code={{oauth.code}}
  3. refreshToken
    POSThttps://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-urlencodedaccept: application/json