# Run in Postman

> Access and utilize the Copyleaks API Postman collection for seamless integration and testing.

Postman is a popular tool that simplifies API testing and development. Copyleaks provides a Postman collection that covers all available API calls. This document will guide you through setting up the collection and making requests.

### Get Started
<Steps>
  <Step title="Fork the Copyleaks Postman Collection">
    - Sign up or log in to your account on [**Postman**](https://www.postman.com)
    - Click the button below to access the Copyleaks Postman collection:
    <a href="https://god.gw.postman.com/run-collection/25022653-e2c2987f-c1b5-462f-8590-71d28b7f4b32?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D25022653-e2c2987f-c1b5-462f-8590-71d28b7f4b32%26entityType%3Dcollection%26workspaceId%3D21147b7c-8cb3-4566-8f5d-8dfc6926eb5e" target="_blank" rel="noopener noreferrer">
      <img src="https://run.pstmn.io/button.svg" alt="Run In Postman" style={{ width: 128, height: 32, marginLeft: 20 }} />
    </a>
    - Select **Fork Collection**
    - Name your fork and select a workspace
  </Step>

  <Step title="Authenticate Your API Requests">
    - To make API calls, you need to authenticate:
      - Find your **API Key** in the **[API Dashboard](https://api.copyleaks.com/dashboard)**
      - In Postman, select your fork of the Copyleaks collection
      - Go to the **Variables** tab and enter the following values in the **CURRENT VALUE** column:
        - **email**: `YOUR_EMAIL_ADDRESS`
        - **key**: `YOUR_API_KEY`
      - Save the changes
      - After logging in, check the response for the `access_token`
      - Take the value of the `access_token` and place it in the Authorization tab of your fork in Postman as the value of Token. All endpoints will inherit this token from the parent and will use it for authentication automatically
  </Step>

  <Step title="Make API Calls">
    You can now start making API requests. 

    For example, to run an AI detection scan:
      - In your Postman workspace, navigate to your fork of the Copyleaks collection
      - Select **AI Detection** > **Submit Natural Language** > Update the request body and add the scan ID, then click **Send**
      - Review the response
  </Step>
</Steps>

## Next Steps
<CardGroup cols={2}>
    <Card title="Copyleaks API in Postman" icon="paper-plane" href="https://www.postman.com/copyleaks-api">Check out our Copyleaks API Postman Profile</Card>
    <Card title="Postman Collection" icon="code" href="https://documenter.getpostman.com/view/25022653/2sB34foMwz#188b7bdf-4a34-4397-88dc-ca892747dbd3">Visit the complete Copyleaks API Postman Collection documentation</Card>
    <Card title="Account Documentation" icon="user" href="/reference/actions/account/overview/">Learn how to authenticate and get started with Copyleaks APIs</Card>
    <Card title="Scans Methods" icon="magnifying-glass" href="/reference/actions/authenticity/overview">Discover the full list of available Scans Methods Endpoints. Submit, start, and manage plagiarism scans</Card>
</CardGroup>
