Mocks
Mock servers in Insomnia
A mock server is a tool used to simulate API endpoints. These can be particularly useful while designing an API. Insomnia offers cloud-hosted mock servers, but you can also deploy self-hosted mocks.
Cloud-hosted mocks
The Insomnia Cloud mock servers allow you to create a mock endpoint in a few steps. You simply need to provide an endpoint and a sample response. You get a number or free mock requests based on your plan. For more details, see the pricing page.
Self-hosted mocks
Enterprise users can deploy self-hosted mock servers using Insomnia Mockbin. This allows you to have more control over usage for your mocks.
Security warnings
- Always be sure you trust the author of a mock server before calling it, visiting it, or adding it to your code.
- Like any URL, mock servers can contain malicious content or redirects.
- To enable easy use from anywhere, especially for front-end feature development, Insomnia’s mock servers have a very permissive CORS configuration (
Access-Control-Allow-Origin: *
,Access-Control-Allow-Credentials: true
). A malicious API could be used to exfiltrate data.
Frequently asked questions
Are mock servers available for all users?
Yes, all plans have access to mocks, with some limitations based on the plan. Enterprise users have unlimited requests on cloud-hosted mock servers and have the option to deploy self-hosted mocks. See the API mocking section of the pricing page for more information.
Can I automatically generate mock endpoints?
Yes, you can generate a mock endpoint from a request response. After sending a request, go to the Mock tab in the right panel and select or create a new mock server and route. The generated endpoint will contain the response body, headers, and status.