Updating a profile with Postman

Written by Soraya Paula

Updated on December 12th, 2024

Table of contents

Before you start Running the script Video guide

You can use the two endpoints below to update existing browser profiles:

The “POST Profile Update” endpoint allows you to update all the parameters of a profile
The “POST Profile Partial Update” endpoint allows you to change any profile parameters separately

In the “POST Profile Partial Update” endpoint you can only change values for parameters that accept custom inputs, such as proxy, name, navigator_masking, localization_masking, geolocation_masking, and so on.

Before you start

Complete all three steps from this article, including “Using the bearer token”: they will allow you to sign in correctly
Insert your value into the below variable in the script:
1. profile_id: get this value from the DevTools panel or from the URL on a profile settings page (click the three dots in the profile list → “Edit”)

Running the script

Full profile update

Navigate to the "Profile Management" section in your Postman workspace and select "POST Profile Update” endpoint
Go to the “Body” tab and customize the needed parameters
Click "Send" to execute the request: a "200" status means success

Partial profile update

Navigate to the "Profile Management" section in your Postman workspace and select "POST Profile Partial Update” endpoint
Go to the “Body” tab and add your values for the custom parameters such as proxy, name, navigator_masking, localization_masking, geolocation_masking, and so on.
Click "Send" to execute the request: a "200" status means success

Script example

{
    "name": "Test updated",
    "profile_id": "569e4e66-b7ba-42f5-9622-3f4e2337ac3a",
    "notes": "notes",
    "proxy": {
        "host": "<string>", #IP or HOST
        "type": "url", #HTTP or SOCKS5
        "port": "<integer>", #PORT
        "username": "<string>",
        "password": "<string>"
    },
    "parameters": {
        "flags": {
            "audio_masking": "natural",
            "fonts_masking": "mask",
            "geolocation_masking": "mask",
            "geolocation_popup": "prompt",
            "graphics_masking": "mask",
            "graphics_noise": "mask",
            "localization_masking": "mask",
            "media_devices_masking": "natural",
            "navigator_masking": "mask",
            "ports_masking": "mask",
            "proxy_masking": "custom",
            "screen_masking": "natural",
            "timezone_masking": "mask",
            "webrtc_masking": "mask"
        },
        "storage": {
            "is_local": false,
            "save_service_worker": false
        },
        "fingerprint": {}
        }
    }

Video guide

Contact Us