1.2. Your First Customizations

In this chapter, you’ll build your first customizations with Medusa.

You'll create a GET API route at the path /hello-world. An API route exposes your application's commerce features to frontend clients, such as the admin dashboard or a storefront.

Medusa has Store and Admin API routes, and you can create custom API routes for your custom features.

1. Create API Route#

API Routes expose business logic through REST APIs. You can create custom API routes to expose custom business logic.

To create an API route, create the file src/api/hello-world/route.ts with the following content:

src/api/hello-world/route.ts
1import type {2  MedusaRequest,3  MedusaResponse,4} from "@medusajs/framework/http"5
6export const GET = (7  req: MedusaRequest,8  res: MedusaResponse9) => {10  res.json({11    message: "Hello, world!",12  })13}

2. Test Customizations#

To test out your customizations:

1. Start the Medusa application:

npm
yarn
pnpm

2. Send a GET request to /hello-world:

Code
curl http://localhost:9000/hello-world

In the response, you’ll receive the following object:

Code
1{2  "message": "Hello, world!"3}

Next Steps#

Congratulations, you’ve made your first customization with Medusa!

You can now start your in-depth learning journey to become an expert.