---
title: "Create Session"
method: POST
path: "/api/v1/importer/sessions"
tags: ["Create Session"]
---

# Create Session

`POST /api/v1/importer/sessions`

Use this endpoint to generate an importer session token based on an importer slug. The session token should be used as part of creating a fuse importer instance.

## Request body

- object
  - `importer_slug` string, required — Importer Slug
  - `metadata` object — Contains meta information about the importer session which can contain user related information

## Response `201`

successful

- object
  - `token` string, required — JWT token for the importer session

## Other responses

- `404` — importer not found
- `422` — unprocessable entity

## Changes

- **2024-10-04** `343f04cd3ee6` — 1 warning, 1 info
  - removed the request property `meta`
  - added the new optional request property `metadata`
- **2024-09-13** `6a3a97e75a2e` — 1 breaking, 1 warning
  - added the new required request property `importer_slug`
  - removed the request property `template_slug`
- **2024-09-06** `d90abb8038b6` — 3 info
  - api tag `Create Session` added
  - api tag `Importer Sessions` removed
  - added the media type `application/json` for the response with the status `201`
- **2024-06-06** `368b33190e26` — 1 info
  - endpoint added
- **2024-01-06** `4645adc06898` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/swovohq/apis/api-v1/changes/api/v1/importer/sessions/post.md)

---

[API](https://skmtc.dev/swovohq/apis/api-v1.md) · [All operations](https://skmtc.dev/swovohq/apis/api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/swovohq/api-v1/revisions/1bd225911f40/schema)