Zoho Desk's API enables you to build automated workflows and increase the efficiency of your customer service operations. With the API you can build integrations, create custom solutions for customer service, or quickly create a tool for custom reporting. Here are some examples of what you can build using the Zoho Desk API:
import { axios } from "@pipedream/platform"
export default defineComponent({
props: {
zoho_desk: {
type: "app",
app: "zoho_desk",
}
},
async run({steps, $}) {
return await axios($, {
url: `https://desk.${this.zoho_desk.$auth.region}/api/v1/myProfile`,
headers: {
"Authorization": `Zoho-oauthtoken ${this.zoho_desk.$auth.oauth_access_token}`,
},
})
},
})
Zoho Desk uses OAuth authentication. When you connect your Zoho Desk account, Pipedream will open a popup window where you can sign into Zoho Desk 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 Desk API.
Pipedream requests the following authorization scopes when you connect your account:
Desk.articles.CREATE
Desk.articles.READ
Desk.articles.UPDATE
Desk.basic.CREATE
Desk.basic.READ
Desk.contacts.CREATE
Desk.contacts.READ
Desk.contacts.UPDATE
Desk.contacts.WRITE
Desk.events.CREATE
Desk.events.READ
Desk.events.UPDATE
Desk.events.WRITE
Desk.search.READ
Desk.settings.CREATE
Desk.settings.READ
Desk.settings.UPDATE
Desk.settings.WRITE
Desk.tasks.CREATE
Desk.tasks.READ
Desk.tasks.UPDATE
Desk.tasks.WRITE
Desk.tickets.CREATE
Desk.tickets.READ
Desk.tickets.UPDATE
Desk.tickets.WRITE
GET
https://accounts.zoho.com/oauth/v2/auth
?
client_id={{oauth.client_id}}
&
redirect_uri={{oauth.redirect_uri}}
&
state={{oauth.state}}
&
response_type=code
&
scope={{oauth.space_separated_scopes}}
&
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
content-type: application/x-www-form-urlencoded
accept: application/json
client_id={{oauth.client_id}}
&
client_secret={{oauth.client_secret}}
&
grant_type=refresh_token
&
refresh_token={{oauth.refresh_token}}