---
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-09-23"
---

# 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",
)
```

```json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Organization",
      "@id": "https://verbafy.io/#organization",
      "name": "Verbafy",
      "url": "https://verbafy.io",
      "inLanguage": "en",
      "knowsAbout": [
        "YouTube transcription",
        "Spotify episode transcription",
        "Meeting recording transcription",
        "Speaker diarization",
        "Transcript export"
      ],
      "hasOfferCatalog": {
        "@id": "https://verbafy.io/pricing#offers"
      },
      "contactPoint": {
        "@type": "ContactPoint",
        "contactType": "customer support",
        "email": "support@verbafy.io",
        "url": "https://verbafy.io/contact"
      }
    },
    {
      "@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",
      "inLanguage": "en",
      "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"
        }
      ]
    }
  ]
}
```
