---
title: "Create Job"
method: POST
path: "/v2/jobs"
---

# Create Job

`POST /v2/jobs`

Create a transcription job.

## Request body

- CreateJobRequestBody
  - `type` 'TRANSCRIPTION', required
  - `apiKey` string, uuid, required
  - `mediaUrl` string, uri, required
  - `title` string, required
  - `language` 'ar' | 'en', required — Language code for the media being transcribed
  - `processingType` 'async' | 'sync'
  - `webhookUrl` string, uri
  - `webhookAuth` object
    - `authKey` string, required
    - `authSecret` string, required

## Response `200`

Successful response with job id

- object
  - `success` boolean
  - `message` string
  - `messageKey` string
  - `data` CreateJobResponse
    - `jobId` string, required

## Other responses

- `400` — Validation error response
- `500` — Internal server error response

---

[API](https://skmtc.net/tryhamsa/apis/hamsa-api.md) · [All operations](https://skmtc.net/tryhamsa/apis/hamsa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryhamsa/hamsa-api/versions/ecbeb5d8dc13/schema)