--- title: "Automating TOEFL Score Import with TOEFL Access Touchless Solution" slug: "automating-toefl-score-import-with-edm-touchless-solution" updated: 2026-08-18T21:01:10Z published: 2026-08-18T21:01:10Z canonical: "knowledge.technolutions.net/automating-toefl-score-import-with-edm-touchless-solution" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.technolutions.net/llms.txt > Use this file to discover all available pages before exploring further. # Automating TOEFL Score Import with TOEFL Access Touchless Solution [Educational Testing Service](http://ets.org) (ETS) lets approved score users view **Test of English as a Foreign Language (TOEFL)** scores through [TOEFL Access](https://toeflaccess.ets.org/). > [!WARNING] > πŸ“Note > > Please note that support for the PGP Scorelink [source format](/v1/docs/the-source-format-library) has been discontinued. Transition to the automated EDM Touchless Solution for TOEFL score imports as described in this article for reliability, automation, and ease of maintenance. ## Step 1: Receiving the API key Automatically fetching TOEFL data via API requires an ETS-provided API key, which contains the encoded Client ID and Client Secret. To get the API key: 1. Go to [TOEFL Access](https://toeflaccess.ets.org/) and log in. 2. Go to **Integrations β†’ Server-to-Server feeds.** If you don’t have access, [go to the TOEFL Access website and follow steps to request access.](https://www.ets.org/toefl/toeflaccess.html) 3. If you already have an integration account, copy the existing API key from the Integrations section. If you don’t have a prior integration account, [generate a new key from TOEFL Access.](https://intercom.help/toeflaccess/en/articles/11826666-generate-new-api-key) 4. Keep the API key handy for the next steps in the integration process. > [!NOTE] > πŸ’‘ Setting up GRE scores too? > > When you set up your [GRE integration](/v1/docs/automating-gre-and-toefl-score-import-with-ets-data-manager-touchless-solution), use this API key in place of the base64 encoded value described in the first section of the GRE article. ## Step 2: Adding the TOEFL test types > [!WARNING] > πŸ“ Starting **January 21, 2026**, you must add a new TOEFL Internet-based test type to your database. 1. Go to **Database** β†’ [**Suitcase**](/v1/docs/suitcase#importing-a-suitcase-0-5) 2. Click **Import.** 3. In the text field, paste the Suitcase ID of the shared Suitcase item: ```plaintext ca9d347f-a088-4a8d-b5ed-1bd16661a549:slate-examples ``` 4. Click **Retrieve.** ## Step 3: Adding the source format To add the TOEFL source format: 1. Go to **Database β†’ Source Format Library.** 2. Search for **TOEFL.** 3. Next to **TOEFL Score Data File: Fixed Width >01/2026**, select **Add.** A pop-up appears. 4. Select **Add**. A pop-up appears that describes the source format. 5. Select **Add**. A browser dialog appears. 6. Select **OK.** You are redirected to the overview page for the source format. ## Step 4: Configuring the import The Score Data File automatically fetches score results shared with your institution. 1. Go to **Database β†’ Source Formats.** 2. Select **TOEFL Score Data File (Format: Fixed Width >01/2026)**. 3. Select **Edit**. 4. Select the **Import Automation** **tab**. 5. In the **Import Remote Server** field, paste the following URL: ```plaintext https://toeflaccess-api.ets.org/scores?startdate={{dtstart|date:'s'}}&enddate={{dtend|date:'s'}}&type=TOEFL&reportby=scorelinkbyreportdate ``` > [!CAUTION] > πŸ”” **Important:** Copy the new URL exactly as shown above. Do not add or remove any spaces, characters, or line breaks. Optionally, if you are retrieving department-specific TOEFL data you will add the dept code to the end of the above url, i.e., `dept=UG` ```plaintext https://toeflaccess-api.ets.org/scores?startdate={{dtstart|date:'s'}}&enddate={{dtend|date:'s'}}&type=TOEFL&reportby=scorelinkbyreportdate&dept=UG ``` 1. In the **HTTP Headers** field, add the following tag: ```http ``` 2. Between the opening and closing tags, paste the **API key** you created earlier as part of [step one](/v1/docs/automating-toefl-score-import-with-edm-touchless-solution#step-1-receiving-the-api-key). 3. By default, all currently valid TOEFL scores released to your institution will be sent during the first fetch. If you prefer this option, select **Save.** If you'd like to override this default, continue to [overriding the last remote server fetch](/v1/docs/automating-toefl-score-import-with-edm-touchless-solution#optional-overriding-the-last-remote-server-fetch). [![Import_Automation_Configurations_-_TOEFL.png](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/15497733453723.png?sv=2026-02-06&spr=https&st=2026-11-12T18%3A27%3A20Z&se=2026-11-12T19%3A27%3A20Z&sr=c&sp=r&sig=YHx3hJ76zyPT%2FdaArXnX1nEvukj4pxUi6ShJeN%2FVkCQ%3D)](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/15497733453723.png?sv=2026-02-06&spr=https&st=2026-11-12T18%3A27%3A20Z&se=2026-11-12T19%3A27%3A20Z&sr=c&sp=r&sig=YHx3hJ76zyPT%2FdaArXnX1nEvukj4pxUi6ShJeN%2FVkCQ%3D) ## Optional: Overriding the last remote server fetch Overriding this value will limit the fetch to just those since the last import. 1. To the right of the **Last Remote Server Fetch (UTC)** field, select **Override.** 2. Enter the case-sensitive confirmation message. 3. Select **OK.** 4. In the **Last Remote Server Fetch (UTC) field**, enter the approximate timestamp, in the format `yyyy-MM-ddTHH:mm:ss` (for example, `2023-04-05T03:22:30`), that the source format should send to EDMTOEFL to restrict the data retrieved during the first data fetch. [![Last_Remote_Server_Fetch.png](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/15471263781787.png?sv=2026-02-06&spr=https&st=2026-11-12T18%3A27%3A20Z&se=2026-11-12T19%3A27%3A20Z&sr=c&sp=r&sig=YHx3hJ76zyPT%2FdaArXnX1nEvukj4pxUi6ShJeN%2FVkCQ%3D)](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/15471263781787.png?sv=2026-02-06&spr=https&st=2026-11-12T18%3A27%3A20Z&se=2026-11-12T19%3A27%3A20Z&sr=c&sp=r&sig=YHx3hJ76zyPT%2FdaArXnX1nEvukj4pxUi6ShJeN%2FVkCQ%3D) 5. Select **Save.** ## Troubleshooting If the connection from the GRE or TOEFL source formats break, the API key has likely expired. To receive the API key for TOEFL Server-to-Server Feeds: 1. Log in to TOEFL Access. 2. Copy your existing API key, or [generate a new API key](https://intercom.help/toeflaccess/en/articles/11826666-generate-new-api-key). 3. Update the configuration in the [ETS Source format](/v1/docs/automating-toefl-score-import-with-edm-touchless-solution#step-3-adding-the-source-format) with the API key. If your server-to-server account integrates with both TOEFL and GRE, you will need to [update your GRE encoded value](/v1/docs/automating-gre-and-toefl-score-import-with-ets-data-manager-touchless-solution#step-3-configuring-the-import) when you update it for TOEFL. #### Additional resources - [Update guide for existing Slate integration users](https://intercom.help/toeflaccess/en/articles/11826779-update-guide-for-existing-slate-integration-users) - [Generate a new API key](https://intercom.help/toeflaccess/en/articles/11826666-generate-new-api-key) - [Important update for both GRE and TOEFL integration accounts](https://intercom.help/toeflaccess/en/articles/12001226-important-update-needed-to-gre-api-key-authcode-password) > [!NOTE] > πŸ’‘ You can also contact TOEFL Access Support at [help.toeflaccess@ets.org](mailto:help.toeflaccess@ets.org)