---
title: "Generar Grant Token"
url: https://docs.catalyst.zoho.com/es/api/oauth2/generate-grant-token/
description: "Conoce el protocolo estándar de la industria OAuth 2.0 que utiliza Catalyst para autenticar y autorizar las solicitudes de API realizadas por los usuarios y obtener acceso seguro a los recursos protegidos de Catalyst."
last_updated: 2026-08-17T12:16:04Z
service: All Services
type: api
---

# Paso 2: Generar Grant Token

Después de generar el `client\_id` y el `client\_secret`, debes generar un Grant Token o `code` para tu aplicación.

> **Nota:** Generar un Grant Token es un proceso que se realiza una sola vez, siempre que generes el `access\_token` y el `refresh\_token` dentro del tiempo de validez del Grant Token. 

### Para aplicaciones Self Client

Si previamente seleccionaste el tipo _Self Client_, debes generar el Grant Token (`code`) de la siguiente manera:

1. Después de registrar tu aplicación, selecciona **Self Client** de la lista de _Applications_ en la
[consola de API](https://api-console.zoho.com/) y haz clic en **Generate Code**.
 ![](https://catalyst-docs-development.zohostratus.in/images/api/catalyst_api_5.webp)
2. Ingresa un scope válido. Puedes consultar la lista de scopes disponibles en Catalyst en [esta sección](https://docs.catalyst.zoho.com/es/api/oauth2/scopes/#Scopes).
3. Elige una duración de tiempo en la lista desplegable. El Grant Token generado en este paso expirará después de este período de tiempo.

> **Nota:** Si el Grant Token está por expirar, debes generar un `refresh\_token` antes de que expire, como se describe en el siguiente paso.

4. Ingresa una descripción para el scope.
5. Haz clic en **Generate**.

La consola de API mostrará el Grant Token generado o el valor de `code` para tu aplicación _Self Client_.

![](https://catalyst-docs-development.zohostratus.in/images/api/catalyst_api_6.webp)

### Para otras aplicaciones

Si previamente seleccionaste tipos de cliente diferentes al tipo _Self Client_, debes generar el Grant Token usando un método de redirección:

1. Envía una solicitud a la siguiente URI con los parámetros indicados a continuación, para generar el Grant Token (`code`):

`https://<span></span>accounts.zoho.com/oauth/v2/auth?`

> **Nota:** Debes acceder a los dominios respectivos para los otros [centros de datos](https://docs.catalyst.zoho.com/es/api/introduction/multi-dc-support/#Multi-DCSupport): 
* **EU:** `https://<span></span>accounts.zoho.eu/`
* **AU:** `https://<span></span>accounts.zoho.au/`
* **IN:** `https://<span></span>accounts.zoho.in/` 
* **CA:** `https://<span></span>accounts.zohocloud.ca/` 
* **JP:** `https://<span></span>accounts.zohocloud.jp/` 
* **SA:** `https://<span></span>accounts.zohocloud.sa/` 

<table class="content-table">
  <thead>
    <tr>
      <th class="w20p">Parámetro</th>
      <th class="w80p">Descripción</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>
        `**scope\***`
      </td>
      <td>
        El scope para el cual se generará el Grant Token. Puedes proporcionar múltiples scopes separándolos con comas. Puedes consultar la lista de scopes disponibles en Catalyst en [esta sección](https://docs.catalyst.zoho.com/es/api/oauth2/scopes/#Scopes).
      </td>
    </tr>
    <tr>
      <td>`**client\_id\*** `</td>
      <td>El Client ID que se generó durante el registro del cliente</td>
    </tr>
    <tr>
      <td>`**state** `</td>
      <td>Una cadena opaca que se transmite de ida y vuelta en el protocolo, es decir, cualquier valor que proporciones aquí se te devolverá</td>
    </tr>
    <tr>
      <td>`**response\_type\***`</td>
      <td>`code `(Proporciona esta cadena literal como valor) </td>
    </tr>
    <tr>
      <td>`**redirect\_uri\*** `</td>
      <td>Una de las URIs de redirección autorizadas que proporcionaste al registrar el cliente en el paso anterior. No debes proporcionar una URI de redirección no registrada.</td>
    </tr>
    <tr>
      <td>`**access\_type** `</td>
      <td>Los valores permitidos son `offline` y `online`. El `access\_type` online solo proporciona el `Access Token` para tu aplicación, que es válido por una hora. El `access\_type offline` proporciona un `Access Token` así como un `Refresh Token` para tu aplicación. El valor predeterminado se considera `online`.</td>
    </tr>
    <tr>
      <td>`**prompt** `</td>
      <td>`Consent` (Proporciona esta cadena literal como valor) Solicita el consentimiento del usuario cada vez que tu aplicación intenta acceder a las credenciales del usuario. Si no especificas este parámetro, solo se le solicitarán las credenciales al usuario la primera vez que tu aplicación solicite acceso.</td>
    </tr>
  </tbody>
</table>

> **Nota:**

   * Los campos marcados con * son obligatorios.

   * Puedes pasar los parámetros en el cuerpo de tu solicitud como `form-data`, para mayor seguridad.

**Ejemplo de solicitud**

```bash
https://accounts.zoho.com/oauth/v2/auth?scope=ZohoCatalyst.tables.rows.CREATE,ZohoCatalyst.tables.rows.READ,ZohoCatalyst.tables.rows.UPDATE,ZohoCatalyst.tables.rows.DELETE&client_id=1000.0SRSxxxxxxxxxxxxxxxxx&state=testing&response_type=code&redirect_uri=https://www.zylker.com/ShipmentTracking/&access_type=offline
```

2. Si envías el parámetro `prompt` en esta solicitud, se abrirá una página de consentimiento del usuario.
 Después de hacer clic en **Accept**, Zoho te redirigirá a la `redirect\_uri` con el Grant Token en el parámetro `code`. Guarda el valor de `code` para los siguientes pasos.
 ![](https://catalyst-docs-development.zohostratus.in/images/api/catalyst_api_7.webp)
 Según los detalles de tu inicio de sesión, el sistema detecta automáticamente tu dominio y utiliza la URL de autenticación específica del dominio para generar el Grant Token. El parámetro `state` también se pasa en la URL.
 Si haces clic en **Reject**, el navegador redirige a la URI de redirección con el parámetro `error=access\_denied`.

> **Nota:** Este código solo es válido por 60 segundos. Debes completar el siguiente paso dentro de este tiempo.