---
title: App proxy
description: >-
  The `authenticate.public.appProxy` function validates app proxy requests made
  by Shopify, and returns a context to enable querying Shopify APIs.
api_version: v1
api_name: shopify-app-remix
source_url:
  html: >-
    https://shopify.dev/docs/api/shopify-app-remix/v1/authenticate/public/app-proxy
  md: >-
    https://shopify.dev/docs/api/shopify-app-remix/v1/authenticate/public/app-proxy.md
---

# App proxy

The `authenticate.public.appProxy` function validates app proxy requests made by Shopify, and returns a context to enable querying Shopify APIs.

## authenticate.​public.​app​Proxy(**[request](#authenticatepublicappproxy-propertydetail-request)**​)

Authenticates requests coming from Shopify app proxies.

### Parameters

* **request**

  **Request**

  **required**

### Returns

* **Promise\<AppProxyContext | AppProxyContextWithSession>**

### AppProxyContext

* session

  No session is available for the shop that made this request. This comes from the session storage which \`shopifyApp\` uses to store sessions in your database of choice.

  ```ts
  undefined
  ```

* admin

  No session is available for the shop that made this request. Therefore no methods for interacting with the GraphQL / REST Admin APIs are available.

  ```ts
  undefined
  ```

* storefront

  No session is available for the shop that made this request. Therefore no method for interacting with the Storefront API is available.

  ```ts
  undefined
  ```

* liquid

  A utility for creating a Liquid Response.

  ```ts
  LiquidResponseFunction
  ```

### LiquidResponseFunction

* body

  ```ts
  string
  ```

* initAndOptions

  ```ts
  number | (ResponseInit & Options)
  ```

Response

```ts
Response
```

### Options

* layout

  ```ts
  boolean
  ```

### AppProxyContextWithSession

* session

  The session for the shop that made the request. This comes from the session storage which \`shopifyApp\` uses to store sessions in your database of choice. Use this to get shop or user-specific data.

  ```ts
  Session
  ```

* admin

  Methods for interacting with the GraphQL / REST Admin APIs for the store that made the request.

  ```ts
  AdminApiContext<Resources>
  ```

* storefront

  Method for interacting with the Shopify Storefront Graphql API for the store that made the request.

  ```ts
  StorefrontContext
  ```

* liquid

  A utility for creating a Liquid Response.

  ```ts
  LiquidResponseFunction
  ```

### AdminApiContext

* rest

  Methods for interacting with the Shopify Admin REST API There are methods for interacting with individual REST resources. You can also make \`GET\`, \`POST\`, \`PUT\` and \`DELETE\` requests should the REST resources not meet your needs.

  ```ts
  RestClientWithResources<Resources>
  ```

* graphql

  Methods for interacting with the Shopify Admin GraphQL API

  ```ts
  GraphQLClient
  ```

### RestClientWithResources

```ts
RemixRestClient & {resources: Resources}
```

### StorefrontContext

* graphql

  Method for interacting with the Shopify Storefront GraphQL API If you're getting incorrect type hints in the Shopify template, follow \[these instructions]\(https://github.com/Shopify/shopify-app-template-remix/tree/main#incorrect-graphql-hints).

  ```ts
  GraphQLClient
  ```

Examples

### Examples

* #### Using the session object

  ##### Description

  Get your app's data using an offline session for the shop that made the request.

  ##### app/routes/\*\*\\/.ts

  ```typescript
  import { json } from "@remix-run/node";
  import { authenticate } from "../shopify.server";
  import { getMyAppModelData } from "~/db/model.server";

  export const loader = async ({ request }) => {
    const { session } = await authenticate.public.appProxy(request);
    return json(await getMyAppModelData({shop: session.shop));
  };
  ```

* #### Interacting with the Admin API

  ##### Description

  Use the \`admin\` object to interact with the REST or GraphQL APIs.

  ##### app/routes/\*\*\\/.ts

  ```typescript
  import { json } from "@remix-run/node";
  import { authenticate } from "../shopify.server";

  export async function action({ request }: ActionArgs) {
    const { admin } = await authenticate.public.appProxy(request);

    const response = await admin.graphql(
      `#graphql
      mutation populateProduct($input: ProductInput!) {
        productCreate(input: $input) {
          product {
            id
          }
        }
      }`,
      { variables: { input: { title: "Product Name" } } }
    );

    const productData = await response.json();
    return json({ data: productData.data });
  }
  ```

* #### Interacting with the Storefront API

  ##### Description

  Use the \`storefront\` object to interact with the GraphQL API.

  ##### app/routes/\*\*\\/.ts

  ```typescript
  import { json } from "@remix-run/node";
  import { authenticate } from "../shopify.server";

  export async function action({ request }: ActionArgs) {
    const { admin } = await authenticate.public.appProxy(request);

    const response = await storefront.graphql(`{blogs(first: 10) { edges { node { id } } } }`);

    return json(await response.json());
  }
  ```

* #### Rendering liquid content

  ##### Description

  Use the \`liquid\` helper to render a \`Response\` with Liquid content.

  ##### app/routes/\*\*\\/.ts

  ```typescript
  import {authenticate} from "~/shopify.server"

  export async function loader({ request }) {
    const {liquid} = authenticate.public.appProxy(request);

    return liquid("Hello {{shop.name}}")
  }
  ```

## Related

[Interact with the Admin API. - Admin API context](https://shopify.dev/docs/api/shopify-app-remix/apis/admin-api)

[Interact with the Storefront API. - Storefront API context](https://shopify.dev/docs/api/shopify-app-remix/apis/storefront-api)