> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.futurejobs.ai/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.futurejobs.ai/_mcp/server. # Create Sourcing Session POST https://prod.api.futurejobs.ai/api/v1/wl/sourcing-session Content-Type: application/json `POST /sourcing-session` Creates a new sourcing session and triggers the initial profile search. ## Headers | Key | Value | | --- | --- | | x-fj-api-key | fjk_ | | Content-Type | application/json | ## Body | Field | Type | Required | Description | | --- | --- | --- | --- | | sessionTitle | string | no | Human-readable session name. | | jdDetail.userText | string | no | Free-form JD text. | | jdDetail.sampleProfileURL | string | no | Sample LinkedIn URL to anchor the search. | | queries | object | yes | Search filter map (see below). | ### queries object — filter shape Each filter is `{ type, value }`: _value accepts array of strings_ _For skills filter, at least one skill must be provided in mandatory, core, or secondary._ - `country_region — { type: "(.)", value: ["India"] }` - `open_to_cards — { type: "=", value: ["CAREER_INTEREST"] }` - `current_employers.title — { type: "IN", value: [ ".NET Developer", "C# Developer", "Software Engineer", "Web Developer", "Application Developer", "Backend Developer" ] }` - `years_of_experience_raw — { type: "RANGE", value: [1, 5] }` - `skills — { type: "IN", value: { mandatory: ["C#", ".NET Core"], core: [ "ASP.NET MVC", "Web API", "SQL Server", "Entity Framework", "React", "Angular", "Docker" ], secondary: [] } }` - `current_employers.function_category — { type: "IN", value: ["Engineering"] }` - `current_employers.seniority_level — { type: "IN", value: ["Senior"] }` - `current_employers.name — { type: "IN", value: ["Tech Mahindra"] }` - `current_employers.years_at_company — { type: "IN", value: ["1 to 2 years"] }` - `region — { type: "IN", value: ["Pune, Maharashtra, India"] }` - `all_employers.company_industries — { type: "IN", value: [ "Software Development", "IT System Custom Software Development", "Design Services" ] }` - `education_background.institute_name — { type: "IN", value: ["University of Mumbai"] }` - `education_background.field_of_study — { type: "IN", value: [ "Computer Science", "Information Technology", "related field" ] }` - `education_background.degree_name — { type: "IN", value: ["BACHELORS"] }` - `past_employers.name — { type: "IN", value: ["Infosys"] }` - `past_employers.title — { type: "IN", value: ["Software Developer"] }` - `current_employers.company_type — { type: "IN", value: ["Public Company"] }` - `current_employers.company_hq_location — { type: "IN", value: ["Pune, Maharashtra, India"] }` - `current_employers.description — { type: "IN", value: ["B2B Saas"] }` - `funding_stage — { type: "IN", value: ["series_a"] }` - `headcount_growth — { type: "RANGE", value: [10, 20] }` - `current_employers.company_headcount_latest — { type: "RANGE", value: [10, 100] }` - `annual_revenue — { type: "=", value: ["1_10"] }` - `total_funding — { type: "=", value: ["1_10"] }` - `year_founded — { type: "RANGE", value: [2000, 2010] }` - `recently_funded — { type: "=", value: ["6m"] }` - `certifications.name — { type: "IN", value: ["AWS Certified Cloud Practitioner"] }` - `honors.title — { type: "IN", value: ["Dean's list"] }` - `geo_distance — { type: "=", value: ["50_km"] }` - `current_employers.employment_type — { type: "IN", value: ["Part-time", "Permanent"] }` - `current_employers.company_headcount_range — { type: "IN", value: ["51-200"] }` ## Response (200) The created session object. ``` json { "statusCode": 201, "data": { "session": { "sessionTitle": ".NET Developer", "medium": "MANUAL", "jdDetail": { "userText": "Job Title: .NET Developer, Experience: 1-5 years, Location: Pune", "sampleProfileURL": "" }, "queries": { "country_region": { "type": "(.)", "value": [ "India" ] }, "current_employers.title": { "type": "IN", "value": [ ".NET Developer" ] }, "years_of_experience_raw": { "type": "RANGE", "value": [ 1, 5 ] }, "region": { "type": "IN", "value": [ "Pune, Maharashtra, India" ] }, "skills": { "type": "IN", "value": { "mandatory": [ "C#" ], "core": [ "ASP.NET MVC" ], "secondary": [] } } }, "fallbackFilters": null, "hasUsedFinalFallback": false, "nuances": [], "redFlags": "", "mustHaves": "", "additionalNotes": "", "createdBy": "68c505c2ec8d7cb2821599af", "workspaceId": "6a0c5da36e7a0151430c5b71", "projectId": "6a0c5da36e7a0151430c5b7e", "next_cursor": "", "searchMoreCounter": 0, "filterChangesCounter": 0, "lastCandidatesFetchedAt": null, "profileMatchingStatus": "idle", "totalProfilesForMatching": 0, "totalProfilesMatched": 0, "profileMatchingProvider": "gemini", "sessionCreditCharged": false, "forceRefreshAnalysis": false, "totalAvailableProfiles": 0, "metadata": { "s3Key": null, "fileHash": null, "uploadedAt": null }, "_id": "6a0c77936e7a0151430c91fd", "batches": [], "createdAt": "2026-05-19T14:45:39.240Z", "updatedAt": "2026-05-19T14:45:39.240Z", "__v": 0 }, "sourcing": { "total_display_count": 100, "next_cursor": "H4sIAJR3DGoC_xXMMQrDMAxA0asEzx0iS5biXqWUIMs2GUpNE2coIXdvuv4H_3CfvazfedFtcffB-VB5YovKIMQhawm5aCKIqRCaZBBkJWEZk6TRexBvqZrlSrnG4G6D29rar9eDAQgxwPNqvXV9zdb295_QT-cPbAjrQHoAAAA=", "filterChangesCounter": 0, "searchMoreCounter": 0, "profileMatchingStatus": "processing", "newProfilesCount": 100, "creditInfo": { "charged": true, "amount": 5, "reason": "Sourcing Session Created", "remainingCredits": 37 } } }, "message": "Session created successfully", "status": "SUCCESS" } ``` ## cURL Replace `fjk_YOUR_API_KEY_HERE` with your actual key, then paste and run: ``` bash curl -X POST "https://prod.api.futurejobs.ai/api/v1/wl/sourcing-session" \ -H "x-fj-api-key: fjk_YOUR_API_KEY_HERE" \ -H "Content-Type: application/json" \ -d '{ "sessionTitle": ".NET Developer", "jdDetail": { "userText": "Job Title: .NET Developer, Experience: 1-5 years, Location: Pune" }, "queries": { "country_region": { "type": "(.)", "value": ["India"] }, "years_of_experience_raw": { "type": "RANGE", "value": [1, 5] }, "skills": { "type": "IN", "value": { "mandatory": [ "C#", ".NET Core" ], "core": [ "ASP.NET MVC", "Web API", "SQL Server", "Entity Framework", "React", "Angular", "Docker" ], "secondary": [] } } } }' ``` ## Errors - `400 Bad Request` — validation failed (missing/invalid fields). - `401 Unauthorized` — invalid API key. - `402 Payment Required` — insufficient workspace credits. Reference: https://docs.futurejobs.ai/fj-sourcing-ap-is/sourcing-session/create-sourcing-session ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: FJ Sourcing APIs version: 1.0.0 paths: /api/v1/wl/sourcing-session: post: operationId: create-sourcing-session summary: Create Sourcing Session description: >- `POST /sourcing-session` Creates a new sourcing session and triggers the initial profile search. ## Headers | Key | Value | | --- | --- | | x-fj-api-key | fjk_ | | Content-Type | application/json | ## Body | Field | Type | Required | Description | | --- | --- | --- | --- | | sessionTitle | string | no | Human-readable session name. | | jdDetail.userText | string | no | Free-form JD text. | | jdDetail.sampleProfileURL | string | no | Sample LinkedIn URL to anchor the search. | | queries | object | yes | Search filter map (see below). | ### queries object — filter shape Each filter is `{ type, value }`: _value accepts array of strings_ _For skills filter, at least one skill must be provided in mandatory, core, or secondary._ - `country_region — { type: "(.)", value: ["India"] }` - `open_to_cards — { type: "=", value: ["CAREER_INTEREST"] }` - `current_employers.title — { type: "IN", value: [ ".NET Developer", "C# Developer", "Software Engineer", "Web Developer", "Application Developer", "Backend Developer" ] }` - `years_of_experience_raw — { type: "RANGE", value: [1, 5] }` - `skills — { type: "IN", value: { mandatory: ["C#", ".NET Core"], core: [ "ASP.NET MVC", "Web API", "SQL Server", "Entity Framework", "React", "Angular", "Docker" ], secondary: [] } }` - `current_employers.function_category — { type: "IN", value: ["Engineering"] }` - `current_employers.seniority_level — { type: "IN", value: ["Senior"] }` - `current_employers.name — { type: "IN", value: ["Tech Mahindra"] }` - `current_employers.years_at_company — { type: "IN", value: ["1 to 2 years"] }` - `region — { type: "IN", value: ["Pune, Maharashtra, India"] }` - `all_employers.company_industries — { type: "IN", value: [ "Software Development", "IT System Custom Software Development", "Design Services" ] }` - `education_background.institute_name — { type: "IN", value: ["University of Mumbai"] }` - `education_background.field_of_study — { type: "IN", value: [ "Computer Science", "Information Technology", "related field" ] }` - `education_background.degree_name — { type: "IN", value: ["BACHELORS"] }` - `past_employers.name — { type: "IN", value: ["Infosys"] }` - `past_employers.title — { type: "IN", value: ["Software Developer"] }` - `current_employers.company_type — { type: "IN", value: ["Public Company"] }` - `current_employers.company_hq_location — { type: "IN", value: ["Pune, Maharashtra, India"] }` - `current_employers.description — { type: "IN", value: ["B2B Saas"] }` - `funding_stage — { type: "IN", value: ["series_a"] }` - `headcount_growth — { type: "RANGE", value: [10, 20] }` - `current_employers.company_headcount_latest — { type: "RANGE", value: [10, 100] }` - `annual_revenue — { type: "=", value: ["1_10"] }` - `total_funding — { type: "=", value: ["1_10"] }` - `year_founded — { type: "RANGE", value: [2000, 2010] }` - `recently_funded — { type: "=", value: ["6m"] }` - `certifications.name — { type: "IN", value: ["AWS Certified Cloud Practitioner"] }` - `honors.title — { type: "IN", value: ["Dean's list"] }` - `geo_distance — { type: "=", value: ["50_km"] }` - `current_employers.employment_type — { type: "IN", value: ["Part-time", "Permanent"] }` - `current_employers.company_headcount_range — { type: "IN", value: ["51-200"] }` ## Response (200) The created session object. ``` json { "statusCode": 201, "data": { "session": { "sessionTitle": ".NET Developer", "medium": "MANUAL", "jdDetail": { "userText": "Job Title: .NET Developer, Experience: 1-5 years, Location: Pune", "sampleProfileURL": "" }, "queries": { "country_region": { "type": "(.)", "value": [ "India" ] }, "current_employers.title": { "type": "IN", "value": [ ".NET Developer" ] }, "years_of_experience_raw": { "type": "RANGE", "value": [ 1, 5 ] }, "region": { "type": "IN", "value": [ "Pune, Maharashtra, India" ] }, "skills": { "type": "IN", "value": { "mandatory": [ "C#" ], "core": [ "ASP.NET MVC" ], "secondary": [] } } }, "fallbackFilters": null, "hasUsedFinalFallback": false, "nuances": [], "redFlags": "", "mustHaves": "", "additionalNotes": "", "createdBy": "68c505c2ec8d7cb2821599af", "workspaceId": "6a0c5da36e7a0151430c5b71", "projectId": "6a0c5da36e7a0151430c5b7e", "next_cursor": "", "searchMoreCounter": 0, "filterChangesCounter": 0, "lastCandidatesFetchedAt": null, "profileMatchingStatus": "idle", "totalProfilesForMatching": 0, "totalProfilesMatched": 0, "profileMatchingProvider": "gemini", "sessionCreditCharged": false, "forceRefreshAnalysis": false, "totalAvailableProfiles": 0, "metadata": { "s3Key": null, "fileHash": null, "uploadedAt": null }, "_id": "6a0c77936e7a0151430c91fd", "batches": [], "createdAt": "2026-05-19T14:45:39.240Z", "updatedAt": "2026-05-19T14:45:39.240Z", "__v": 0 }, "sourcing": { "total_display_count": 100, "next_cursor": "H4sIAJR3DGoC_xXMMQrDMAxA0asEzx0iS5biXqWUIMs2GUpNE2coIXdvuv4H_3CfvazfedFtcffB-VB5YovKIMQhawm5aCKIqRCaZBBkJWEZk6TRexBvqZrlSrnG4G6D29rar9eDAQgxwPNqvXV9zdb295_QT-cPbAjrQHoAAAA=", "filterChangesCounter": 0, "searchMoreCounter": 0, "profileMatchingStatus": "processing", "newProfilesCount": 100, "creditInfo": { "charged": true, "amount": 5, "reason": "Sourcing Session Created", "remainingCredits": 37 } } }, "message": "Session created successfully", "status": "SUCCESS" } ``` ## cURL Replace `fjk_YOUR_API_KEY_HERE` with your actual key, then paste and run: ``` bash curl -X POST "https://prod.api.futurejobs.ai/api/v1/wl/sourcing-session" \ -H "x-fj-api-key: fjk_YOUR_API_KEY_HERE" \ -H "Content-Type: application/json" \ -d '{ "sessionTitle": ".NET Developer", "jdDetail": { "userText": "Job Title: .NET Developer, Experience: 1-5 years, Location: Pune" }, "queries": { "country_region": { "type": "(.)", "value": ["India"] }, "years_of_experience_raw": { "type": "RANGE", "value": [1, 5] }, "skills": { "type": "IN", "value": { "mandatory": [ "C#", ".NET Core" ], "core": [ "ASP.NET MVC", "Web API", "SQL Server", "Entity Framework", "React", "Angular", "Docker" ], "secondary": [] } } } }' ``` ## Errors - `400 Bad Request` — validation failed (missing/invalid fields). - `401 Unauthorized` — invalid API key. - `402 Payment Required` — insufficient workspace credits. tags: - subpackage_sourcingSession parameters: - name: x-fj-api-key in: header required: true schema: type: string responses: '201': description: Created content: application/json: schema: $ref: >- #/components/schemas/Sourcing Session_Create Sourcing Session_Response_201 requestBody: content: application/json: schema: type: object properties: sessionTitle: type: string jdDetail: $ref: >- #/components/schemas/ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaJdDetail queries: $ref: >- #/components/schemas/ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaQueries required: - sessionTitle - jdDetail - queries servers: - url: https://prod.api.futurejobs.ai description: https://prod.api.futurejobs.ai components: schemas: ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaJdDetail: type: object properties: userText: type: string sampleProfileURL: type: string required: - userText - sampleProfileURL title: >- ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaJdDetail ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaQueriesCountryRegion: type: object properties: type: type: string value: type: array items: type: string required: - type - value title: >- ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaQueriesCountryRegion ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaQueriesCurrentEmployersTitle: type: object properties: type: type: string value: type: array items: type: string required: - type - value title: >- ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaQueriesCurrentEmployersTitle ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaQueriesYearsOfExperienceRaw: type: object properties: type: type: string value: type: array items: type: integer required: - type - value title: >- ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaQueriesYearsOfExperienceRaw ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaQueriesRegion: type: object properties: type: type: string value: type: array items: type: string required: - type - value title: >- ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaQueriesRegion ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaQueriesSkillsValue: type: object properties: mandatory: type: array items: type: string core: type: array items: type: string secondary: type: array items: description: Any type required: - mandatory - core - secondary title: >- ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaQueriesSkillsValue ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaQueriesSkills: type: object properties: type: type: string value: $ref: >- #/components/schemas/ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaQueriesSkillsValue required: - type - value title: >- ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaQueriesSkills ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaQueries: type: object properties: country_region: $ref: >- #/components/schemas/ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaQueriesCountryRegion current_employers.title: $ref: >- #/components/schemas/ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaQueriesCurrentEmployersTitle years_of_experience_raw: $ref: >- #/components/schemas/ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaQueriesYearsOfExperienceRaw region: $ref: >- #/components/schemas/ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaQueriesRegion skills: $ref: >- #/components/schemas/ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaQueriesSkills required: - country_region - current_employers.title - years_of_experience_raw - region - skills title: ApiV1WlSourcingSessionPostRequestBodyContentApplicationJsonSchemaQueries ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionJdDetail: type: object properties: userText: type: string sampleProfileURL: type: string required: - userText - sampleProfileURL title: >- ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionJdDetail ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionQueriesCountryRegion: type: object properties: type: type: string value: type: array items: type: string required: - type - value title: >- ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionQueriesCountryRegion ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionQueriesCurrentEmployersTitle: type: object properties: type: type: string value: type: array items: type: string required: - type - value title: >- ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionQueriesCurrentEmployersTitle ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionQueriesYearsOfExperienceRaw: type: object properties: type: type: string value: type: array items: type: integer required: - type - value title: >- ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionQueriesYearsOfExperienceRaw ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionQueriesRegion: type: object properties: type: type: string value: type: array items: type: string required: - type - value title: >- ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionQueriesRegion ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionQueriesSkillsValue: type: object properties: mandatory: type: array items: type: string core: type: array items: type: string secondary: type: array items: description: Any type required: - mandatory - core - secondary title: >- ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionQueriesSkillsValue ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionQueriesSkills: type: object properties: type: type: string value: $ref: >- #/components/schemas/ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionQueriesSkillsValue required: - type - value title: >- ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionQueriesSkills ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionQueries: type: object properties: country_region: $ref: >- #/components/schemas/ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionQueriesCountryRegion current_employers.title: $ref: >- #/components/schemas/ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionQueriesCurrentEmployersTitle years_of_experience_raw: $ref: >- #/components/schemas/ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionQueriesYearsOfExperienceRaw region: $ref: >- #/components/schemas/ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionQueriesRegion skills: $ref: >- #/components/schemas/ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionQueriesSkills required: - country_region - current_employers.title - years_of_experience_raw - region - skills title: >- ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionQueries ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionMetadata: type: object properties: s3Key: description: Any type fileHash: description: Any type uploadedAt: description: Any type title: >- ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionMetadata ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSession: type: object properties: sessionTitle: type: string medium: type: string jdDetail: $ref: >- #/components/schemas/ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionJdDetail queries: $ref: >- #/components/schemas/ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionQueries fallbackFilters: description: Any type hasUsedFinalFallback: type: boolean nuances: type: array items: description: Any type redFlags: type: string mustHaves: type: string additionalNotes: type: string createdBy: type: string workspaceId: type: string projectId: type: string next_cursor: type: string searchMoreCounter: type: integer filterChangesCounter: type: integer lastCandidatesFetchedAt: description: Any type profileMatchingStatus: type: string totalProfilesForMatching: type: integer totalProfilesMatched: type: integer profileMatchingProvider: type: string sessionCreditCharged: type: boolean forceRefreshAnalysis: type: boolean totalAvailableProfiles: type: integer metadata: $ref: >- #/components/schemas/ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSessionMetadata _id: type: string batches: type: array items: description: Any type createdAt: type: string format: date-time updatedAt: type: string format: date-time __v: type: integer required: - sessionTitle - medium - jdDetail - queries - hasUsedFinalFallback - nuances - redFlags - mustHaves - additionalNotes - createdBy - workspaceId - projectId - next_cursor - searchMoreCounter - filterChangesCounter - profileMatchingStatus - totalProfilesForMatching - totalProfilesMatched - profileMatchingProvider - sessionCreditCharged - forceRefreshAnalysis - totalAvailableProfiles - metadata - _id - batches - createdAt - updatedAt - __v title: >- ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSession ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSourcingCreditInfo: type: object properties: charged: type: boolean amount: type: integer reason: type: string remainingCredits: type: number format: double required: - charged - amount - reason - remainingCredits title: >- ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSourcingCreditInfo ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSourcing: type: object properties: total_display_count: type: integer next_cursor: type: string filterChangesCounter: type: integer searchMoreCounter: type: integer profileMatchingStatus: type: string newProfilesCount: type: integer creditInfo: $ref: >- #/components/schemas/ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSourcingCreditInfo required: - total_display_count - next_cursor - filterChangesCounter - searchMoreCounter - profileMatchingStatus - newProfilesCount - creditInfo title: >- ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSourcing ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaData: type: object properties: session: $ref: >- #/components/schemas/ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSession sourcing: $ref: >- #/components/schemas/ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaDataSourcing required: - session - sourcing title: ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaData Sourcing Session_Create Sourcing Session_Response_201: type: object properties: statusCode: type: integer data: $ref: >- #/components/schemas/ApiV1WlSourcingSessionPostResponsesContentApplicationJsonSchemaData message: type: string status: type: string required: - statusCode - data - message - status title: Sourcing Session_Create Sourcing Session_Response_201 securitySchemes: apiKeyAuth: type: apiKey in: header name: x-fj-api-key ``` ## Examples **Request** ```json { "sessionTitle": ".NET Developer", "jdDetail": { "userText": "Job Title: .NET Developer, Experience: 1-5 years, Location: Pune", "sampleProfileURL": "" }, "queries": { "country_region": { "type": "(.)", "value": [ "India" ] }, "current_employers.title": { "type": "IN", "value": [ ".NET Developer" ] }, "years_of_experience_raw": { "type": "RANGE", "value": [ 1, 5 ] }, "region": { "type": "IN", "value": [ "Pune, Maharashtra, India" ] }, "skills": { "type": "IN", "value": { "mandatory": [ "C#" ], "core": [ "ASP.NET MVC" ], "secondary": [] } } } } ``` **Response** ```json { "statusCode": 201, "data": { "session": { "sessionTitle": ".NET Developer", "medium": "MANUAL", "jdDetail": { "userText": "Job Title: .NET Developer, Experience: 1-5 years, Location: Pune", "sampleProfileURL": "" }, "queries": { "country_region": { "type": "(.)", "value": [ "India" ] }, "current_employers.title": { "type": "IN", "value": [ ".NET Developer" ] }, "years_of_experience_raw": { "type": "RANGE", "value": [ 1, 5 ] }, "region": { "type": "IN", "value": [ "Pune, Maharashtra, India" ] }, "skills": { "type": "IN", "value": { "mandatory": [ "C#" ], "core": [ "ASP.NET MVC" ], "secondary": [] } } }, "hasUsedFinalFallback": false, "nuances": [], "redFlags": "", "mustHaves": "", "additionalNotes": "", "createdBy": "69d89f1379a06d7c932d10ac", "workspaceId": "69f2412fb63fce7fb4e074d5", "projectId": "69d89f1379a06d7c932d10ba", "next_cursor": "", "searchMoreCounter": 0, "filterChangesCounter": 0, "profileMatchingStatus": "idle", "totalProfilesForMatching": 0, "totalProfilesMatched": 0, "profileMatchingProvider": "gemini", "sessionCreditCharged": false, "forceRefreshAnalysis": false, "totalAvailableProfiles": 0, "metadata": {}, "_id": "6a0414b071a196dde7e6f15d", "batches": [], "createdAt": "2026-05-13T06:05:36.008Z", "updatedAt": "2026-05-13T06:05:36.008Z", "__v": 0 }, "sourcing": { "total_display_count": 100, "next_cursor": "H4sIALEUBGoC_xXMMQ7CMAxA0atUmRmS2LEbroJQZTuJOiAi2nRAiLtT1v-k_3Gvo27vZZV9ddfJxdRoJstCgZFSkZpKFcWQtSIYl8BAgkzsldXHGDiaNrPSsLSc3GVye9_G-bqRzww-wP1sow95LNaP558gzt8fhu-qLHoAAAA=", "filterChangesCounter": 0, "searchMoreCounter": 0, "profileMatchingStatus": "processing", "newProfilesCount": 100, "creditInfo": { "charged": true, "amount": 5, "reason": "Sourcing Session Created", "remainingCredits": 39999843.5 } } }, "message": "Session created successfully", "status": "SUCCESS" } ``` **SDK Code** ```python Sourcing Session_Create Sourcing Session_example import requests url = "https://prod.api.futurejobs.ai/api/v1/wl/sourcing-session" payload = { "sessionTitle": ".NET Developer", "jdDetail": { "userText": "Job Title: .NET Developer, Experience: 1-5 years, Location: Pune", "sampleProfileURL": "" }, "queries": { "country_region": { "type": "(.)", "value": ["India"] }, "current_employers.title": { "type": "IN", "value": [".NET Developer"] }, "years_of_experience_raw": { "type": "RANGE", "value": [1, 5] }, "region": { "type": "IN", "value": ["Pune, Maharashtra, India"] }, "skills": { "type": "IN", "value": { "mandatory": ["C#"], "core": ["ASP.NET MVC"], "secondary": [] } } } } headers = { "x-fj-api-key": "", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Sourcing Session_Create Sourcing Session_example const url = 'https://prod.api.futurejobs.ai/api/v1/wl/sourcing-session'; const options = { method: 'POST', headers: {'x-fj-api-key': '', 'Content-Type': 'application/json'}, body: '{"sessionTitle":".NET Developer","jdDetail":{"userText":"Job Title: .NET Developer, Experience: 1-5 years, Location: Pune","sampleProfileURL":""},"queries":{"country_region":{"type":"(.)","value":["India"]},"current_employers.title":{"type":"IN","value":[".NET Developer"]},"years_of_experience_raw":{"type":"RANGE","value":[1,5]},"region":{"type":"IN","value":["Pune, Maharashtra, India"]},"skills":{"type":"IN","value":{"mandatory":["C#"],"core":["ASP.NET MVC"],"secondary":[]}}}}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Sourcing Session_Create Sourcing Session_example package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://prod.api.futurejobs.ai/api/v1/wl/sourcing-session" payload := strings.NewReader("{\n \"sessionTitle\": \".NET Developer\",\n \"jdDetail\": {\n \"userText\": \"Job Title: .NET Developer, Experience: 1-5 years, Location: Pune\",\n \"sampleProfileURL\": \"\"\n },\n \"queries\": {\n \"country_region\": {\n \"type\": \"(.)\",\n \"value\": [\n \"India\"\n ]\n },\n \"current_employers.title\": {\n \"type\": \"IN\",\n \"value\": [\n \".NET Developer\"\n ]\n },\n \"years_of_experience_raw\": {\n \"type\": \"RANGE\",\n \"value\": [\n 1,\n 5\n ]\n },\n \"region\": {\n \"type\": \"IN\",\n \"value\": [\n \"Pune, Maharashtra, India\"\n ]\n },\n \"skills\": {\n \"type\": \"IN\",\n \"value\": {\n \"mandatory\": [\n \"C#\"\n ],\n \"core\": [\n \"ASP.NET MVC\"\n ],\n \"secondary\": []\n }\n }\n }\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("x-fj-api-key", "") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Sourcing Session_Create Sourcing Session_example require 'uri' require 'net/http' url = URI("https://prod.api.futurejobs.ai/api/v1/wl/sourcing-session") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["x-fj-api-key"] = '' request["Content-Type"] = 'application/json' request.body = "{\n \"sessionTitle\": \".NET Developer\",\n \"jdDetail\": {\n \"userText\": \"Job Title: .NET Developer, Experience: 1-5 years, Location: Pune\",\n \"sampleProfileURL\": \"\"\n },\n \"queries\": {\n \"country_region\": {\n \"type\": \"(.)\",\n \"value\": [\n \"India\"\n ]\n },\n \"current_employers.title\": {\n \"type\": \"IN\",\n \"value\": [\n \".NET Developer\"\n ]\n },\n \"years_of_experience_raw\": {\n \"type\": \"RANGE\",\n \"value\": [\n 1,\n 5\n ]\n },\n \"region\": {\n \"type\": \"IN\",\n \"value\": [\n \"Pune, Maharashtra, India\"\n ]\n },\n \"skills\": {\n \"type\": \"IN\",\n \"value\": {\n \"mandatory\": [\n \"C#\"\n ],\n \"core\": [\n \"ASP.NET MVC\"\n ],\n \"secondary\": []\n }\n }\n }\n}" response = http.request(request) puts response.read_body ``` ```java Sourcing Session_Create Sourcing Session_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://prod.api.futurejobs.ai/api/v1/wl/sourcing-session") .header("x-fj-api-key", "") .header("Content-Type", "application/json") .body("{\n \"sessionTitle\": \".NET Developer\",\n \"jdDetail\": {\n \"userText\": \"Job Title: .NET Developer, Experience: 1-5 years, Location: Pune\",\n \"sampleProfileURL\": \"\"\n },\n \"queries\": {\n \"country_region\": {\n \"type\": \"(.)\",\n \"value\": [\n \"India\"\n ]\n },\n \"current_employers.title\": {\n \"type\": \"IN\",\n \"value\": [\n \".NET Developer\"\n ]\n },\n \"years_of_experience_raw\": {\n \"type\": \"RANGE\",\n \"value\": [\n 1,\n 5\n ]\n },\n \"region\": {\n \"type\": \"IN\",\n \"value\": [\n \"Pune, Maharashtra, India\"\n ]\n },\n \"skills\": {\n \"type\": \"IN\",\n \"value\": {\n \"mandatory\": [\n \"C#\"\n ],\n \"core\": [\n \"ASP.NET MVC\"\n ],\n \"secondary\": []\n }\n }\n }\n}") .asString(); ``` ```php Sourcing Session_Create Sourcing Session_example request('POST', 'https://prod.api.futurejobs.ai/api/v1/wl/sourcing-session', [ 'body' => '{ "sessionTitle": ".NET Developer", "jdDetail": { "userText": "Job Title: .NET Developer, Experience: 1-5 years, Location: Pune", "sampleProfileURL": "" }, "queries": { "country_region": { "type": "(.)", "value": [ "India" ] }, "current_employers.title": { "type": "IN", "value": [ ".NET Developer" ] }, "years_of_experience_raw": { "type": "RANGE", "value": [ 1, 5 ] }, "region": { "type": "IN", "value": [ "Pune, Maharashtra, India" ] }, "skills": { "type": "IN", "value": { "mandatory": [ "C#" ], "core": [ "ASP.NET MVC" ], "secondary": [] } } } }', 'headers' => [ 'Content-Type' => 'application/json', 'x-fj-api-key' => '', ], ]); echo $response->getBody(); ``` ```csharp Sourcing Session_Create Sourcing Session_example using RestSharp; var client = new RestClient("https://prod.api.futurejobs.ai/api/v1/wl/sourcing-session"); var request = new RestRequest(Method.POST); request.AddHeader("x-fj-api-key", ""); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"sessionTitle\": \".NET Developer\",\n \"jdDetail\": {\n \"userText\": \"Job Title: .NET Developer, Experience: 1-5 years, Location: Pune\",\n \"sampleProfileURL\": \"\"\n },\n \"queries\": {\n \"country_region\": {\n \"type\": \"(.)\",\n \"value\": [\n \"India\"\n ]\n },\n \"current_employers.title\": {\n \"type\": \"IN\",\n \"value\": [\n \".NET Developer\"\n ]\n },\n \"years_of_experience_raw\": {\n \"type\": \"RANGE\",\n \"value\": [\n 1,\n 5\n ]\n },\n \"region\": {\n \"type\": \"IN\",\n \"value\": [\n \"Pune, Maharashtra, India\"\n ]\n },\n \"skills\": {\n \"type\": \"IN\",\n \"value\": {\n \"mandatory\": [\n \"C#\"\n ],\n \"core\": [\n \"ASP.NET MVC\"\n ],\n \"secondary\": []\n }\n }\n }\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Sourcing Session_Create Sourcing Session_example import Foundation let headers = [ "x-fj-api-key": "", "Content-Type": "application/json" ] let parameters = [ "sessionTitle": ".NET Developer", "jdDetail": [ "userText": "Job Title: .NET Developer, Experience: 1-5 years, Location: Pune", "sampleProfileURL": "" ], "queries": [ "country_region": [ "type": "(.)", "value": ["India"] ], "current_employers.title": [ "type": "IN", "value": [".NET Developer"] ], "years_of_experience_raw": [ "type": "RANGE", "value": [1, 5] ], "region": [ "type": "IN", "value": ["Pune, Maharashtra, India"] ], "skills": [ "type": "IN", "value": [ "mandatory": ["C#"], "core": ["ASP.NET MVC"], "secondary": [] ] ] ] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://prod.api.futurejobs.ai/api/v1/wl/sourcing-session")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```