> ## Documentation Index
> Fetch the complete documentation index at: https://help.pragmachartered.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect the GST portal for your accountant

> Give your accountant read-only access to your GST portal records by confirming an OTP, and disconnect it when you want.

![GST portal panel with the steps to do first, the GST portal username field and the Send OTP button](https://help.pragmachartered.com/images/portal/gst-portal.png)

Your accountant can read your GST returns, GSTR-2B and notices through Pragma if you connect your GST portal account. Only you can do this: the GST portal sends a one-time password (OTP) to the mobile number registered on your GSTIN, which your accountant does not hold.

The access is **read-only**. Your accountant can read your records through Pragma, but cannot file or change anything on the GST portal through it.

Before you start, have your GST portal username and password, and the mobile registered on the GST portal with you. Your accountant must already have your company's GSTIN in Pragma. If they do not, the panel says **Your accountant has no GSTIN on file for your company yet. Ask them to add it, then connect the GST portal here.**

**1. Turn on API access on the GST portal**

Sign in at [gst.gov.in](https://www.gst.gov.in). Open **My Profile** → **Manage API Access**. Set **Enable API Request** to **Yes**, choose a duration of **30 days**, and confirm.

**2. Open the GST portal panel in Pragma**

On your portal page, select **GST portal**. The panel shows the same steps under **Before you connect**.

**3. Enter your username and send the OTP**

In **GST portal username**, enter the username you sign in to gst.gov.in with. Select **Send OTP**. While the request is on its way, the panel shows **Asking the GST portal to send an OTP to your GST-registered mobile…**

**4. Enter the OTP**

When the panel says the GST portal sent an OTP to the mobile registered for your GSTIN, type the six digits into **OTP** and select **Verify**. If the OTP did not arrive or has expired, select **Send a new OTP**.

**5. Check that you are connected**

The panel shows **Checking the OTP with the GST portal…**, then a green message: **Connected as** your username **for GSTIN** your GSTIN, with the time the current session lasts until. The session renews on its own until the access period you chose on the GST portal ends.

You can close the panel while it works; reopen **GST portal** to see where it has got to.

## When the connection ends

When the access period you chose on the GST portal is over, or the session cannot be renewed, the panel says **The connection has ended**. To connect again, turn on API access on the GST portal again if the period is over, then enter your username and select **Send OTP**. The connection also ends if your accountant removes your portal access.

## Disconnect

To stop your accountant reading your GST portal records, open **GST portal** and select **Disconnect**. Confirm with **Disconnect** in **Disconnect the GST portal?**. You can connect again at any time with a new OTP.

## If something goes wrong

| Message | What to do |
| - | - |
| A request to the GST portal is already running for this client. Wait for it to finish. | An OTP request or check is still in progress. Wait a few minutes and try again. |
| Request a new OTP first; the last one is no longer waiting. | Select **Send OTP** again and use the new OTP. |
| Too many attempts. Try again in … seconds. | You can request up to 5 OTPs an hour. Wait, then try again. |
| The GST portal did not answer. Try again in a few minutes. | Try again later. |
| The GST service refused the request. Try again later; if it keeps failing, tell your administrator. | Check that API access is turned on and your username is correct, then try again. If it keeps failing, tell your accountant. |
| The GST portal returned an error. | Read the detail shown under it. Check your username and that API access is turned on, then send a new OTP. |
| The GST portal sent a response Pragma could not read. Try again; if it keeps failing, tell your administrator. | Try again. If it keeps failing, tell your accountant. |
| The GST portal connection is not available for your firm yet. Contact Pragma Chartered support to have it set up. | Your accountant's firm has not set this up yet. Tell your accountant. |
| This client is archived, so nothing new can be sent or recorded for it. Its history stays readable; restore the client to work on it again. | Your accountant has archived your company in Pragma. Contact your accountant. |

> [!NOTE]
>
> Questions about your books? Contact your accountant. Can't sign in at all? [Contact Pragma support](https://app.pragmachartered.com/contact-support).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.