> ## Documentation Index
> Fetch the complete documentation index at: https://zenskar.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Use the customer-facing portal

## View a customer's portal from the dashboard

1. Go to **Customers** and click the customer's row.
2. Click the kebab menu (⋮) next to the **Edit** button and select **View Customer Portal**.

This opens a live session for that customer, the same view they would see if you sent them a portal link.

## Generate a portal session link via API

1. Get your API key to authenticate the request.
2. Send a `POST` request to `https://api.zenskar.com/customer/session` with your organization ID in the `organisation` header, your API key in the `X-API-KEY` header, and a JSON body containing the customer's ID, a `return_url`, and an optional `idle_timeout` in seconds.

```curl theme={null}
curl --location --request POST 'https://api.zenskar.com/customer/session' \
-H 'organisation: c3b949f8-633f-4fec-9105-e2b3a4d06b98' \
-H 'X-API-KEY: <your-api-key>' \
-H 'Content-Type: application/json' \
--data-raw '{"customer_id":"063f8b97-f795-4f0b-89b4-88b114c83f44","return_url":"https://zenskar.com","idle_timeout":3600}'
```

3. Use the `redirect_url` from the response to send the customer directly to their portal session.

<Card title="Reference" icon="link" href="/docs/20240301/product-modules/customers/reference/customer-facing-portal" arrow="true" cta="Learn more">
  See the full session API parameter reference.
</Card>

## Embed the portal in your own website

Because access is session-based, you can embed the portal in your own website or product by generating a session link for the logged-in customer and loading it in an iframe or redirecting them to it, rather than sending them to a separate Zenskar-branded page.
