# Postman

To streamline your experience, we offer a readily available [Postman](https://www.postman.com/) collection that can be effortlessly downloaded and installed, enabling you to seamlessly interact with our API.

Ensure that you have the [Postman](https://www.postman.com/) application installed and running on your system, then proceed to download our Postman collection below and follow the provided steps to import it into Postman.

Open the Postman application and click on the **import** button at the top under the collections pad

<figure><img src="https://2001322700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiLJk7NFk70NqFY1GU7Oi%2Fuploads%2FoHpohuqpeUucWB7JYT4C%2F01-postman-import-collection.png?alt=media&#x26;token=2af7ad28-69bc-4eb5-a013-6ba5df3f2ba8" alt=""><figcaption></figcaption></figure>

Drag & drop the following Postman collection and click on **import**

{% file src="<https://2001322700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiLJk7NFk70NqFY1GU7Oi%2Fuploads%2Fh55bhS4JappDGEDVn7Uy%2FTextMaster%20API%20v1.postman_collection.json?alt=media&token=664b6730-db44-4a7a-ac95-66de2ac10fe8>" %}

<figure><img src="https://2001322700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiLJk7NFk70NqFY1GU7Oi%2Fuploads%2FQ06vcekSK7JvA1cZRnxZ%2F02-postman-import-collection.png?alt=media&#x26;token=47ecec07-a7ae-4eee-a58a-c521f8379b7c" alt=""><figcaption></figcaption></figure>

Once the collection is imported, click again on the **import** button at the top

<figure><img src="https://2001322700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiLJk7NFk70NqFY1GU7Oi%2Fuploads%2Fl0RLNweBqNn3RHcZY5AA%2FXnapper-2023-06-12-16.21.00.png?alt=media&#x26;token=c168bdb5-3a1c-4541-b9be-409b0d4c0a58" alt=""><figcaption></figcaption></figure>

Drag & drop the following Postman environment and click on **import**

{% file src="<https://2001322700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiLJk7NFk70NqFY1GU7Oi%2Fuploads%2FmOj4fa34YUpr5oGFiMOY%2Fstaging.json?alt=media&token=5f4d6ba7-6434-4c21-ac8c-7d87d09ea74f>" %}

<figure><img src="https://2001322700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiLJk7NFk70NqFY1GU7Oi%2Fuploads%2FsMAA7pzWg0uCxMkTxZKQ%2FXnapper-2023-06-12-16.22.30.png?alt=media&#x26;token=f6e84c6f-9844-40df-9225-8efc4f2bc6b2" alt=""><figcaption></figcaption></figure>

Time to head back to your TextMaster account and go into the **API & Loop** page

<figure><img src="https://2001322700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiLJk7NFk70NqFY1GU7Oi%2Fuploads%2FfsblUxJwBaq1zN9ud23B%2FXnapper-2023-06-12-15.22.21.png?alt=media&#x26;token=4130f60e-50c4-422a-a835-806a3828b103" alt=""><figcaption></figcaption></figure>

Head to **View OAuth Applications**

<figure><img src="https://2001322700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiLJk7NFk70NqFY1GU7Oi%2Fuploads%2FZMzTBqVMPrSwr2zlhiUY%2FXnapper-2023-06-12-15.23.25.png?alt=media&#x26;token=983e07db-98a4-4b03-a385-5311de41c886" alt=""><figcaption></figcaption></figure>

If you don't have any, **create a new OAuth application**

<figure><img src="https://2001322700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiLJk7NFk70NqFY1GU7Oi%2Fuploads%2FBsxyzHpFiZVO0wNBX8Jo%2FXnapper-2023-06-12-15.23.46.png?alt=media&#x26;token=dd9b8f39-ef1c-49b3-a452-036e961f7a18" alt=""><figcaption></figcaption></figure>

Fill in your new application's details and click **save**

<figure><img src="https://2001322700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiLJk7NFk70NqFY1GU7Oi%2Fuploads%2Fmt1URmvHJnSltGPFhzDc%2FXnapper-2023-06-12-15.24.47.png?alt=media&#x26;token=635b1218-71b2-49d3-b046-2f80d2575431" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Tips:** Use appropriate callback URL and permissions for production applications.
{% endhint %}

**Copy to your clipboard** the client ID and secret to be pasted in Postman's application

<figure><img src="https://2001322700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiLJk7NFk70NqFY1GU7Oi%2Fuploads%2F0iIQ6c42aodeSmhC0wpb%2FXnapper-2023-06-12-15.26.07.png?alt=media&#x26;token=a36e3bb5-39d6-4aa7-9a71-87f28405065d" alt=""><figcaption></figcaption></figure>

**Paste** the client ID and secret into the Postman environment your imported earlier

<figure><img src="https://2001322700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiLJk7NFk70NqFY1GU7Oi%2Fuploads%2FGTX1gbWywdfb9tlH9RE0%2FXnapper-2023-06-12-15.45.25.png?alt=media&#x26;token=7fe49de9-6dfa-4d17-befd-7fe8bbb9c1aa" alt=""><figcaption></figcaption></figure>

**Set** this environment as **active**

<figure><img src="https://2001322700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiLJk7NFk70NqFY1GU7Oi%2Fuploads%2F4phdQoRhlmbn0lhi99zc%2FXnapper-2023-06-12-16.29.52.png?alt=media&#x26;token=4980a358-4177-44e4-bd8c-7e5ee810d13d" alt=""><figcaption></figcaption></figure>

Going back into the **collections pad** and into the **TextMaster API v1 collection**, request a **new access token** at the bottom of the page under the **Authorization** tab

<figure><img src="https://2001322700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiLJk7NFk70NqFY1GU7Oi%2Fuploads%2FloM1HD8qnirQsh4prlDN%2FXnapper-2023-06-12-15.41.14.png?alt=media&#x26;token=59021cc4-d80c-42bd-8fb7-7407f62f99bf" alt=""><figcaption></figcaption></figure>

Postman will open a new window asking you to **authenticate** using your TextMaster credentials

<figure><img src="https://2001322700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiLJk7NFk70NqFY1GU7Oi%2Fuploads%2FoeWdw2j37d0O7vdjai1U%2FXnapper-2023-06-12-15.43.43.png?alt=media&#x26;token=5997c64a-aea4-4084-9460-90bb3d8f7c7e" alt=""><figcaption></figcaption></figure>

**Authorize** your OAuth Application to perform operations on your behalf through the Postman application

<figure><img src="https://2001322700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiLJk7NFk70NqFY1GU7Oi%2Fuploads%2FUxCaOeRFGXL9W50DTRFl%2FXnapper-2023-06-12-15.47.02.png?alt=media&#x26;token=57a684ad-693e-46fc-a11a-28a8e01ecc66" alt=""><figcaption></figcaption></figure>

Once the OAuth Application has been approved, Postman should list the available access tokens, make sure to use the latest one if you have multiple instances of them. **Click on the use token button**

<figure><img src="https://2001322700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiLJk7NFk70NqFY1GU7Oi%2Fuploads%2FJqBOOB8YWJCSDStTawmO%2FXnapper-2023-06-12-15.48.44.png?alt=media&#x26;token=58f343d5-ad0b-4381-b30b-9eee166ea244" alt=""><figcaption></figcaption></figure>

Finally, verify everything works as expected by executing the **Retrieve my information** endpoint

<figure><img src="https://2001322700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiLJk7NFk70NqFY1GU7Oi%2Fuploads%2Fv0aaqd2WnsoYrQhvpwg0%2FXnapper-2023-06-12-15.49.15.png?alt=media&#x26;token=e850a298-2b15-4bb2-843f-6d98dce5d55f" alt=""><figcaption></figcaption></figure>

Congratulations! You now have a fully working Postman collection you can use to query our API.
