---
title: "Create a visit access grant"
method: POST
path: "/v1/visits/{visit_id}/access_grants"
tags: ["Visits"]
---

# Create a visit access grant

`POST /v1/visits/{visit_id}/access_grants`

## Path parameters

- `visit_id` string, required

## Request body

- CreateVisitAccessGrantRequest
  - `recipient_name` string, nullable — Display name shown as the guest's identity on the visit (e.g. the reviewer's name).
  - `recipient_email` string, nullable — Contact email recorded for the guest. Not used for authentication.
  - `metadata` object, nullable — Arbitrary structured data to attach to this grant (e.g. your own user or task ids). Echoed back verbatim in the create response. Never interpreted by NavigateAI.
  - `expires_at` string, date-time, nullable — When the access link stops working, as an ISO 8601 UTC timestamp (e.g. `2026-12-31T23:59:59Z`). Must be in the future and timezone-aware. Omit for a link that never expires.

## Response `200`

OK

- VisitAccessGrantResponse
  - `visit_access_grant_id` string, required
  - `visit_id` string, required
  - `token` string, required
  - `deeplink_url` string, required
  - `expires_at` string, date-time, nullable, required
  - `metadata` object, nullable, required — The arbitrary structured data attached at creation, echoed back verbatim.

---

[API](https://skmtc.net/navigateai/apis/navigateai-api.md) · [All operations](https://skmtc.net/navigateai/apis/navigateai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/navigateai/navigateai-api/revisions/5fb236d03a88/schema)