---
description: Create Interview API
---

# Create Interview

## Create Interview

> Create a new interview.

OpenAPI:

```json
{"openapi":"3.0.3","info":{"title":"ZekoAI Interview APIs","version":"1.0.0"},"servers":[{"url":"https://interview-api.zeko.ai","description":"Production Server"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/api/v1/interview/create":{"post":{"tags":["Interview"],"summary":"Create Interview","description":"Create a new interview.","operationId":"createInterview","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["interviewName","jdType","jd"],"properties":{"interviewName":{"type":"string"},"roleName":{"type":"string"},"minExperience":{"type":"integer"},"maxExperience":{"type":"integer"},"jdType":{"type":"string","enum":["text","link"]},"jd":{"type":"string"},"sampleQuestions":{"type":"array","items":{"type":"string"}},"interviewConfig":{"type":"object","properties":{"redirectUrl":{"type":"string","format":"uri"},"allowAccess":{"type":"string","enum":["anyone","scheduledCandidates"]},"allowLateAttempts":{"type":"boolean"},"allowContinueFromMiddle":{"type":"boolean"},"allowContinueFromMiddleCount":{"type":"integer"},"allowReattempt":{"type":"boolean"},"allowReattemptCount":{"type":"integer"},"allowInterviewOnMobile":{"type":"boolean"},"allowScreenLeaveCount":{"type":"integer"},"allowTabSwitchCount":{"type":"integer"},"webhookUrl":{"type":"string","format":"uri"}}},"metaData":{"type":"object","properties":{"Id":{"type":"integer"},"name":{"type":"string"},"clientId":{"type":"integer"}}},"published":{"type":"boolean"}}}}}},"responses":{"201":{"description":"Interview created successfully","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"message":{"type":"string"},"success":{"type":"boolean"},"data":{"type":"object","description":"Actual response data object"}}},{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","properties":{"interviewId":{"type":"string"},"status":{"type":"string","enum":["draft","published"]},"interviewLink":{"type":"string","nullable":true},"competencyData":{"type":"array","items":{"type":"object","properties":{"questionCount":{"type":"integer"},"time":{"type":"integer"},"competency":{"type":"string"},"explanation":{"type":"string"},"difficulty":{"type":"string"},"questionType":{"type":"string"},"category":{"type":"string"},"sampleQuestions":{"type":"array","items":{"type":"string"}}}}},"metaData":{"type":"object","properties":{"Id":{"type":"integer"},"name":{"type":"string"},"clientId":{"type":"integer"}}}}}}}]}}}},"401":{"description":"Missing or invalid Authorization header","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"success":{"type":"boolean"},"error":{"nullable":true,"description":"Error details: Error Message"}},"required":["message","success","error"]}}}},"422":{"description":"Input Validation failed","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"success":{"type":"boolean"},"error":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}}}}},"required":["message","success","error"]}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"$ref":"#/paths/~1api~1v1~1interview~1create/post/responses/401/content/application~1json/schema/properties"},"required":["message","success","error"]}}}}}}}}}
```
