Creating mock servers in Postman - Automation Script Walkthrough

Create and test a Postman mock server for a simple API

Preconditions (2)

Step 1: Open Postman and select the collection to mock

Step 2: Click on the three dots next to the collection name and select 'Mock Collection'

Step 3: In the mock server creation dialog, choose 'Save the mock server URL as an environment variable'

Step 4: Click 'Create Mock Server'

Step 5: Copy the mock server URL from the environment variable

Step 6: Send a request to the mock server URL using the same endpoint and method as in the collection

Step 7: Verify the response matches the example response defined in the collection

✅ Expected Result: The mock server is created successfully, and requests sent to the mock server URL return the example response with status code 200

Automation Requirements - Postman test scripts

Assertions Needed:

Verify response status code is 200

Verify response body matches the example response

Best Practices:

Use environment variables to store mock server URL

Use example responses in collection requests for mocking

Write clear and simple test scripts in Postman

Automated Solution

Postman

pm.test('Status code is 200', () => {
    pm.response.to.have.status(200);
});

pm.test('Response body matches example', () => {
    const exampleResponse = pm.collectionVariables.get('exampleResponse');
    const responseBody = pm.response.json();
    pm.expect(responseBody).to.eql(JSON.parse(exampleResponse));
});

The first test checks that the response status code is 200, which means the mock server responded successfully.

The second test compares the actual response body with the example response stored in a collection variable called 'exampleResponse'. This ensures the mock server returns the expected data.

Using environment and collection variables helps keep the test flexible and maintainable.

Common Mistakes - 3 Pitfalls

Not using environment variables for the mock server URL

Not defining example responses in the collection requests

Not verifying the response status code in tests

Bonus Challenge

Now add data-driven testing by creating multiple example responses for different scenarios and verify the mock server returns the correct response based on request parameters.

Show Hint

Practice

1. What is the main purpose of creating a mock server in Postman?

easy

A. To monitor live API traffic

B. To deploy the real API to production

C. To write code for the backend server

D. To simulate API responses without needing the actual backend

Solution

1. Step 1: Understand what a mock server does

   A mock server simulates API responses so developers can test without a real backend.

2. Step 2: Compare options with this purpose

   Only To simulate API responses without needing the actual backend describes simulating responses without the actual backend.

3. Final Answer:

   To simulate API responses without needing the actual backend -> Option D

4. Quick Check:

   Mock server purpose = simulate API responses [OK]

Hint: Mock servers simulate, not deploy or write backend code [OK]

Common Mistakes:

• Confusing mock servers with real backend deployment
• Thinking mock servers monitor live traffic
• Assuming mock servers generate backend code

2. Which of the following is the correct step to create a mock server in Postman?

easy

A. Select a collection, then click 'Mock Server' and configure settings

B. Write backend code and deploy it to Postman

C. Create a new environment and add variables

D. Run the collection in the runner without any setup

Solution

1. Step 1: Identify how to create a mock server

   In Postman, mock servers are created from collections by selecting 'Mock Server' option.

2. Step 2: Check which option matches this process

   Select a collection, then click 'Mock Server' and configure settings correctly describes selecting a collection and clicking 'Mock Server'.

3. Final Answer:

   Select a collection, then click 'Mock Server' and configure settings -> Option A

4. Quick Check:

   Create mock server = select collection + 'Mock Server' [OK]

Hint: Mock servers start from collections, not environments or code [OK]

Common Mistakes:

• Confusing environment setup with mock server creation
• Thinking mock servers require backend code
• Trying to run collections without mock server setup

3. Given this Postman mock server setup:

{
  "method": "GET",
  "url": "/user/123",
  "response": {
    "status": 200,
    "body": "{\"id\":123, \"name\": \"Alice\"}"
  }
}

What will the mock server return when a GET request is made to /user/123?

medium

A. HTTP 404 Not Found error

B. HTTP 200 with body {"id":123, "name": "Alice"}

C. HTTP 500 Internal Server Error

D. No response because URL is incorrect

Solution

1. Step 1: Analyze the mock server response setup

   The mock server is set to respond to GET /user/123 with status 200 and JSON body {"id":123, "name": "Alice"}.

2. Step 2: Match the request and response

   A GET request to /user/123 matches the mock setup, so it returns status 200 and the JSON body.

3. Final Answer:

   HTTP 200 with body {"id":123, "name": "Alice"} -> Option B

4. Quick Check:

   Matching URL + method = 200 + JSON body [OK]

Hint: Match method and URL exactly to get mock response [OK]

Common Mistakes:

• Assuming 404 if unsure about URL matching
• Confusing status codes for mock responses
• Ignoring the method type in mock setup

4. You created a mock server but when sending requests, you always get a 404 error. What is the most likely cause?

medium

A. The request method is POST but mock expects GET

B. The mock server is down due to network issues

C. The mock server URL does not match the request URL

D. The collection has no example responses defined

Solution

1. Step 1: Understand 404 in mock server context

   A 404 means the mock server did not find a matching request URL and method.

2. Step 2: Identify common causes for 404

   If the request URL does not exactly match the mock server URL, 404 occurs. This is the most common cause.

3. Final Answer:

   The mock server URL does not match the request URL -> Option C

4. Quick Check:

   404 error = URL mismatch [OK]

Hint: Check exact URL match to fix 404 errors on mock servers [OK]

Common Mistakes:

• Assuming network issues cause 404
• Forgetting to add example responses in collection
• Ignoring HTTP method mismatch

5. You want to create a mock server that returns different responses based on query parameters. Which approach should you use in Postman?

hard

A. Create multiple example requests in the collection with different query parameters and responses

B. Write JavaScript code in the mock server to handle query parameters

C. Use environment variables to change the mock server URL dynamically

D. Create separate mock servers for each query parameter value

Solution

1. Step 1: Understand how Postman mock servers handle query parameters

   Postman mock servers match requests to example requests including query parameters to return the correct response.

2. Step 2: Identify the best way to handle different query parameters

   Creating multiple example requests with different query parameters and responses allows the mock server to return varied responses.

3. Final Answer:

   Create multiple example requests in the collection with different query parameters and responses -> Option A

4. Quick Check:

   Multiple examples = varied responses by query [OK]

Hint: Use multiple examples with query params for varied mock responses [OK]

Common Mistakes:

• Thinking mock servers run custom code
• Trying to change mock URL with environment variables
• Creating many mock servers instead of examples