---
title: "Create or reuse a Guest session"
description: "Creates a seven-day Guest session cookie when none is valid. Production may require turnstileToken. New creates are limited to 3 per client IP per 3600 seconds."
canonical: "https://verbafy.io/docs/api/auth/create-guest-session"
last-updated: "2026-10-04"
---

# Create or reuse a Guest session

Creates a seven-day Guest session cookie when none is valid. Production may require turnstileToken. New creates are limited to 3 per client IP per 3600 seconds.

`POST /api/v1/auth/guest-sessions`

OpenAPI operation `createGuestSession`. This route does not use Clerk JWT or API key auth. Machine-readable contract: [OpenAPI](/openapi.json).

## curl

```curl
curl -X POST 'https://verbafy.io/api/v1/auth/guest-sessions'
```

## JavaScript

```javascript
const response = await fetch('https://verbafy.io/api/v1/auth/guest-sessions', {
  method: 'POST'
});
```

## Python

```python
import httpx

response = httpx.post(
    "https://verbafy.io/api/v1/auth/guest-sessions",
)
```

## Responses

| Status | Description |
| --- | --- |
| `200` | Guest session created or reused |
| `400` | Validation or domain request error |
| `403` | Turnstile, ownership, or permission denied |
| `429` | Guest-session create rate limit for this client IP |
| `503` | Dependency unavailable |

```json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Organization",
      "@id": "https://verbafy.io/#organization",
      "name": "Verbafy",
      "url": "https://verbafy.io",
      "logo": {
        "@type": "ImageObject",
        "url": "https://verbafy.io/opengraph-image.png"
      },
      "knowsAbout": [
        "YouTube transcription",
        "Spotify episode transcription",
        "Meeting recording transcription",
        "Speaker diarization",
        "Transcript export"
      ],
      "hasOfferCatalog": {
        "@type": "OfferCatalog",
        "@id": "https://verbafy.io/pricing#offers"
      },
      "contactPoint": {
        "@type": "ContactPoint",
        "contactType": "customer support",
        "email": "support@verbafy.io",
        "url": "https://verbafy.io/contact"
      }
    },
    {
      "@type": "WebSite",
      "@id": "https://verbafy.io/#website",
      "url": "https://verbafy.io",
      "name": "Verbafy",
      "inLanguage": "en",
      "publisher": {
        "@id": "https://verbafy.io/#organization"
      }
    },
    {
      "@type": "TechArticle",
      "@id": "https://verbafy.io/docs/api/auth/create-guest-session#page",
      "name": "Create or reuse a Guest session",
      "description": "Creates a seven-day Guest session cookie when none is valid. Production may require turnstileToken. New creates are limited to 3 per client IP per 3600 seconds.",
      "url": "https://verbafy.io/docs/api/auth/create-guest-session",
      "image": "https://verbafy.io/opengraph-image.png",
      "datePublished": "2026-09-09",
      "dateModified": "2026-10-04",
      "inLanguage": "en",
      "author": {
        "@type": "Organization",
        "@id": "https://verbafy.io/#organization",
        "name": "Verbafy"
      },
      "isPartOf": {
        "@id": "https://verbafy.io/#website"
      },
      "publisher": {
        "@id": "https://verbafy.io/#organization"
      }
    },
    {
      "@type": "BreadcrumbList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "name": "Home",
          "item": "https://verbafy.io"
        },
        {
          "@type": "ListItem",
          "position": 2,
          "name": "Create or reuse a Guest session",
          "item": "https://verbafy.io/docs/api/auth/create-guest-session"
        }
      ]
    }
  ]
}
```
