Skip to main content

Creating a profile with Postman

This guide walks you through using the POST Profile Create endpoint in Postman to create profiles, either individually or in bulk. By following these steps, you can automate profile creation with a simple script, streamlining your workflow.

Prerequisites​

Before you begin, ensure you have completed the following steps:

  1. Configure Postman Authentication: Complete the three steps outlined in How to Set Up Indigo X API with Postman, including the "Configure the Bearer Token for Requests" section, to ensure proper sign-in.
  2. Access the Postman Workspace: Navigate to the Profile Management folder in your Postman workspace.
  3. Select the Endpoint: Choose the POST Profile Create endpoint from the Profile Management folder.

Step 1: Prepare the Script​

To create profiles, you need to configure the script with the required variables. Below are the key variables you need to set:

  • folder_id: The ID of the folder where the profile will be created. Obtain this using one of the following methods:
  • fingerprint: Custom fingerprint parameters (e.g., user agent, geolocation) are required only if the corresponding flags are set to custom.

Example Script​

Below is a sample script for creating a profile. Replace <FOLDER_ID> with your actual folder ID and adjust other parameters as needed.

{
  "name": "Test",
  "folder_id": "<FOLDER_ID>",
  "core_version": 124,
  "browser_type": "mimic",
  "os_type": "windows",
  "parameters": {
    "storage": {
      "is_local": false,
      "save_service_worker": true
    },
    "flags": {
      "audio_masking": "mask",
      "fonts_masking": "custom",
      "geolocation_masking": "custom",
      "geolocation_popup": "prompt",
      "graphics_masking": "mask",
      "graphics_noise": "mask",
      "localization_masking": "custom",
      "media_devices_masking": "custom",
      "navigator_masking": "custom",
      "ports_masking": "mask",
      "proxy_masking": "custom",
      "screen_masking": "custom",
      "timezone_masking": "custom",
      "webrtc_masking": "custom"
    },
    "fingerprint": {
      "navigator": {
        "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Safari/537.36",
        "hardware_concurrency": 2,
        "os_cpu": "windows",
        "platform": "Win32"
      },
      "localization": {
        "accept_languages": "ro-RO",
        "languages": "ro-RO",
        "locale": "ro-RO"
      },
      "timezone": {
        "zone": "Europe/Bucharest"
      },
      "graphic": {
        "vendor": "ANGLE (NVIDIA, NVIDIA GeForce RTX 4070 Ti Direct3D11 vs_5_0 ps_5_0, D3D11)",
        "renderer": "Google Inc. (NVIDIA)"
      },
      "webrtc": {
        "public_ip": "192.165.22.1"
      },
      "fonts": [
        "Arial",
        "Calibri",
        "Cambria Math"
      ],
      "media_devices": {
        "video_inputs": 1,
        "audio_inputs": 2,
        "audio_outputs": 1
      },
      "screen": {
        "width": 1920,
        "height": 1080,
        "pixel_ratio": 2
      },
      "geolocation": {
        "latitude": 55,
        "longitude": -54,
        "altitude": 100,
        "accuracy": 152
      },
      "ports": [
        65535
      ],
      "cmd_params": {
        "params": [
          {
            "flag": "disable-notifications",
            "value": "true"
          }
        ]
      }
    }
  }
}
Customizing Parameters

Adjust the fingerprint fields (e.g., user_agent, geolocation, timezone) based on your use case. Ensure the corresponding flags are set to custom to apply these settings.

Step 2: Configure Bulk Profile Creation​

To create multiple profiles at once (up to 10), specify the times parameter in your request. This parameter defines how many profiles to create with the provided configuration.

  1. Add the times parameter to your script or Postman request body: 
    {
      "times": 5,
      ...
    }
  2. Ensure all other parameters (e.g., folder_id, fingerprint) are correctly set.
Bulk Creation Limit

You can create up to 10 profiles at a time. Exceeding this limit may result in an error.

Step 3: Execute the Request​

  1. In Postman, ensure the POST Profile Create endpoint is selected.
  2. Paste your configured script into the request body.
  3. Click Send to execute the request.
  4. Check the response:
    • A 200 OK status indicates success.
    • Any errors will return a different status code with details in the response body.
Success!

A 200 status means your profile(s) were created successfully. You can verify them in the specified folder.

Troubleshooting​

If you encounter issues, check the following:

  • Invalid folder_id: Ensure the folder ID is correct and accessible.
  • Missing Bearer Token: Confirm that the bearer token is included in the request headers.
  • Incorrect Fingerprint Parameters: If a flags value is set to custom, ensure the corresponding fingerprint field is provided.
  • Rate Limits: If creating multiple profiles, ensure you’re within the 10-profile limit.

For further assistance, refer to our API Documentation or contact support.