Sync cookies using Postman Interceptor and the Postman proxy

Postman enables you to capture and sync cookies from a browser or client application. You can sync cookies using either the Postman proxy or Postman Interceptor at any time, without starting a proxy or Interceptor session.

Once configured, Postman continuously captures cookies from the browser or client applications. For the domains you specify, captured cookies are automatically synced to your Postman cookie jar. You can then use the cookies when sending requests from Postman.

You can't sync cookies with the Postman web app. Make sure you've installed the Postman desktop app.

You can also capture requests and cookies during a proxy or Interceptor session. Learn more about capturing requests and cookies with the Postman proxy or Postman Interceptor.

Syncing cookies with Postman Interceptor

Postman Interceptor is a browser extension that captures network requests directly from a web browser and saves them to Postman. You can use Interceptor to continuously sync the cookies in your browser to the Postman cookie jar. You can then use the synced cookies when sending requests in Postman.

The cookie jar always has the latest value for a given cookie. If you need to observe how cookie values change during a request flow, start an Interceptor session.

To sync cookies using the Postman Interceptor, do the following:

1. Install the Postman Interceptor extension by following the steps in Installing Interceptor.

2. Select Cookies in the Postman footer.

3. In the Cookies window, select the Sync Cookies tab and select the Interceptor option.

   Make sure you get the message Connected. If you get the message Disconnected, make sure your browser is open and the Interceptor extension is installed.

4. Enter one or more Domains. Postman will sync cookies for the specified domains to the cookie jar.

   Adding a domain automatically syncs cookies for its subdomains as well. For example, adding the domain example.com will also sync cookies from m.example.com. To sync cookies for the domain only, you can add https:// in front of the domain, such as https://example.com.

5. Select Start Syncing.

Postman is ready to capture and sync cookies using Interceptor.

• Cookies for the domains you specified are automatically synced from your browser to Postman.
• To stop syncing cookies for a domain, select next to the domain name.
• To stop capturing and syncing all cookies, select Stop Syncing.

Syncing cookies from the Interceptor extension

You can also use the Interceptor extension to automatically sync cookies from your browser to the Postman cookie jar, without starting an Interceptor session.

Open the Interceptor extension from your browser's toolbar and select the Sync Cookies tab. Enter the domains you want to sync cookies for and select Sync Cookies. For more information, see Using Postman Interceptor.

Syncing cookies with the Postman proxy

A proxy acts as an intermediary between a client application (like a mobile app) and a server (like an API). You can use Postman's built-in proxy to capture any cookies passing between a client and a server. The captured cookies are synced to the Postman cookie jar for later use.

The cookie jar always has the latest value for a given cookie. If you need to observe how cookie values change during a request flow, start a proxy session.

To sync cookies using the Postman proxy, do the following:

1. Select Cookies in the Postman footer.

2. In the Cookies window, select the Sync Cookies tab and select the Proxy option.

3. Enter a Port number. The default value is 5559. You will use this port number when configuring clients.

   You can't change the port number while the proxy is enabled.

4. Turn on the toggle next to Enable Postman as a proxy.

5. Enter one or more Domains. Postman will sync cookies for the specified domains to the cookie jar.

   Adding a domain automatically syncs cookies for its subdomains as well. For example, adding the domain example.com will also sync cookies from m.example.com. To sync cookies for the domain only, you can add https:// in front of the domain, such as https://example.com.

6. Select Start Syncing.

Postman is ready to capture and sync cookies using the proxy.

• To start syncing cookies, configure one or more clients to use the Postman proxy. Learn more about configuring the proxy on a client device.
• To stop syncing cookies for a domain, select next to the domain name.
• To stop capturing and syncing all cookies, select Stop Syncing.