# Zendesk

> Manage Zendesk Support tickets, comments, users, and organizations via the Zendesk API v2.

Lets an agent triage your Zendesk Support desk - list and search tickets, reply with comments, look up users and organizations, and create, update, or solve tickets.

## What it can do

| Method | What it does |
| --- | --- |
| `zendesk_tickets_list` | List tickets; filter by status, paginate via limit/offset. |
| `zendesk_tickets_get` | Get one ticket by id. |
| `zendesk_tickets_create` | Create a new ticket - subject and description required (write). |
| `zendesk_tickets_update` | Partially update a ticket - status, priority, assignee, tags, internal note (write). |
| `zendesk_ticket_comments_list` | List comments on a ticket. |
| `zendesk_ticket_comments_create` | Add a public or internal comment to a ticket (write). |
| `zendesk_users_list` | List users; filter by role, paginate via limit/offset. |
| `zendesk_users_get` | Get one user by id. |
| `zendesk_users_search` | Search users by email, name, or role. |
| `zendesk_organizations_list` | List organizations, paginate via limit/offset. |
| `zendesk_organizations_get` | Get one organization by id. |
| `zendesk_tickets_search` | Search tickets with Zendesk Query Language (CQL). |
| `zendesk_ticket_status_me` | Get the currently authenticated user (self). |
| `zendesk_ticket_mark_as_solved` | Mark a ticket as solved, with an optional internal note (write). |

## How to get credentials

You need three values: your Zendesk subdomain, your agent email, and an API token.

1. Note your subdomain - it is the `{subdomain}` in `https://{subdomain}.zendesk.com`.
2. In Zendesk, open **Admin Center - Apps and integrations - APIs - Zendesk API**.
3. Make sure **Token access** is enabled, then **Add API token**.
4. Copy the generated token now - it is shown only once.
5. Use your Zendesk account email (e.g. `agent@company.com`) for authentication.

See [About API tokens](https://support.zendesk.com/hc/en-us/articles/4408889192858) for details.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `ZENDESK_SUBDOMAIN` | The `{subdomain}` in `https://{subdomain}.zendesk.com` |
| `ZENDESK_EMAIL` | Your Zendesk account email (e.g. `agent@company.com`) |
| `ZENDESK_API_TOKEN` | Admin Center - Apps and integrations - APIs - Zendesk API - Add API token |