# Zoho Books

API configuration: [`zoho-books`](https://terapi.dev/providers.yaml)

### Features

| Features                                                                                                                                        | Status                        |
| ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| [Auth (OAuth)](https://github.com/shahab-bahojb-basketAsia/terapi-docs/blob/main/integrate/guides/authorize-an-api/README.md)                   | ✅                             |
| [Sync data](https://github.com/shahab-bahojb-basketAsia/terapi-docs/blob/main/integrate/guides/sync-data-from-an-api/README.md)                 | ✅                             |
| [Perform workflows](https://github.com/shahab-bahojb-basketAsia/terapi-docs/blob/main/integrate/guides/perform-workflows-with-an-api/README.md) | ✅                             |
| [Proxy requests](https://github.com/shahab-bahojb-basketAsia/terapi-docs/blob/main/integrate/guides/proxy-requests-to-an-api/README.md)         | ✅                             |
| [Receive webhooks](https://github.com/shahab-bahojb-basketAsia/terapi-docs/blob/main/integrate/guides/receive-webhooks-from-an-api/README.md)   | 🚫 (time to contribute: <48h) |

We can implement missing features in <48h, just ask for it in the [community](https://terapi.dev/slack).

### Getting started

* [How to register an Application](https://accounts.zoho.com/developerconsole)
* [OAuth-related docs](https://www.zoho.com/books/api/v3/oauth/#overview)
* [List of OAuth scopes](https://www.zoho.com/books/api/v3/oauth/#overview)
* [Web API docs (their REST API)](https://www.zoho.com/books/api/v3/apicollection/#overview)

Do you need help? Please check this link [community](https://terapi.dev/slack).

### API gotchas

* Depending on the region of the end-user account you are accessing, you will have to provide the region as an extension in the [connection configuration](https://github.com/shahab-bahojb-basketAsia/terapi-docs/blob/main/integrate/guides/authorize-an-api/README.md#apis-requiring-connection-specific-configuration-for-authorization). No matter whether you created your OAUth app in the EU or US, if you want to obtain the credentials of a user with an EU account, you will have to call: `terapi.auth('zoho-books', '1', {params: { extension: 'eu' }})`. You can find all the available extensions [here](https://www.zoho.com/books/api/v3/introduction/#multidc).
* You can make your OAuth app cross-data-centers with [these instructions](https://www.zoho.com/books/api/v3/introduction/#multidc). This allows a single OAuth application to make requests to the Zoho API for Zoho accounts from the US, EU, etc.

Add Getting Started links and Gotchas by [editing this page](https://github.com/terapihq/terapi/tree/master/docs-v2/integrations/all/zoho-books.mdx)