--- updatedAt: 2026-05-27T10:11:03.000Z agentTools: projectIndex: https://developers.manatal.com/llms.txt --- # /candidates/ Create a new candidate. # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "title": "Manatal Open API", "description": "Manatal Open API documentation and API reference", "version": "v3" }, "security": [ { "api_key": [] } ], "paths": { "/candidates/": { "post": { "operationId": "candidates_create", "description": "Create a new candidate.", "requestBody": { "$ref": "#/components/requestBodies/candidates_createData" }, "responses": { "201": { "description": "", "content": { "application/json": { "schema": { "required": [ "full_name" ], "type": "object", "properties": { "id": { "title": "ID", "type": "integer", "readOnly": true }, "external_id": { "title": "External id", "description": "Id of the candidate in the API consumer systems", "type": "string", "maxLength": 255, "nullable": true }, "full_name": { "title": "Full name", "description": "Full name of the candidate", "type": "string", "maxLength": 255, "minLength": 1 }, "creator": { "title": "Creator", "description": "User who created the candidate", "type": "integer", "readOnly": true }, "owner": { "title": "Owner", "description": "ID of the owner of the candidate - default to creator if none is provided", "type": "integer", "nullable": true }, "source_type": { "title": "Source type", "description": "Origin of the candidate", "type": "string", "enum": [ "sourced", "applied", "referred", "agency", "other" ] }, "source_other": { "title": "Source other", "description": "Field to add manual information to the source if the source_type is other", "type": "string", "maxLength": 255, "nullable": true }, "source_details": { "title": "Source details", "description": "The source details of the candidate", "type": "object", "properties": { "type": { "type": "string" }, "channel": { "type": "string" }, "portal": { "type": "object", "properties": { "id": { "type": "integer" }, "display_name": { "type": "string" } } }, "referrer": { "type": "object", "properties": { "id": { "type": "integer" }, "full_name": { "type": "string" } } }, "agency": { "type": "object", "properties": { "id": { "type": "integer" }, "given_name": { "type": "string" } } }, "other_label": { "type": "string" }, "reference": { "type": "string" } } }, "consent": { "title": "Consent", "description": "Whether the candidate gave permission to use his data (GDPR,Brazil's LGPD, USA´s CCPA ...)", "type": "boolean", "nullable": true }, "consent_date": { "title": "Consent date", "description": "Date at which the candidate gave his consent", "type": "string", "format": "date-time", "readOnly": true }, "picture": { "title": "Picture", "description": "Link to the candidate picture", "type": "string", "readOnly": true, "format": "uri" }, "email": { "title": "Email", "description": "Candidate email", "type": "string", "format": "email", "maxLength": 254, "nullable": true }, "resume": { "title": "Resume", "description": "Link to the candidate resume", "type": "string", "readOnly": true, "minLength": 1 }, "phone_number": { "title": "Phone number", "description": "Candidate phone number", "type": "string", "maxLength": 255, "nullable": true }, "gender": { "title": "Gender", "description": "Gender of the candidate", "type": "string", "enum": [ "male", "female", "other", "unknown" ], "nullable": true }, "birth_date": { "title": "Birth date", "description": "Candidate birth date", "type": "string", "format": "date", "nullable": true }, "address": { "title": "Address", "description": "Full address of the candidate", "type": "string", "maxLength": 255 }, "zipcode": { "title": "Zipcode", "description": "Code for the city of the address field", "type": "string", "maxLength": 255 }, "latest_degree": { "title": "Latest degree", "description": "Latest degree obtained by the candidate", "type": "string", "maxLength": 255, "nullable": true }, "latest_university": { "title": "Latest university", "description": "Latest university the candidate graduated from", "type": "string", "maxLength": 255, "nullable": true }, "current_company": { "title": "Current company", "description": "Company where the candidate currently works", "type": "string", "maxLength": 255, "nullable": true }, "current_department": { "title": "Current department", "description": "Department where the candidate works", "type": "string", "maxLength": 255, "nullable": true }, "current_position": { "title": "Current position", "description": "Position of the candidate at his current job", "type": "string", "maxLength": 255, "nullable": true }, "description": { "title": "Description", "description": "Description of the candidate - can only input text here.", "type": "string" }, "hash": { "title": "Hash", "description": "Unique hash of the candidate", "type": "string", "readOnly": true, "minLength": 1 }, "custom_fields": { "title": "Custom fields", "description": "Candidate values for custom fields defined in Manatal.", "type": "object" }, "created_at": { "title": "Created at", "description": "Date at which the candidate was created", "type": "string", "format": "date-time", "readOnly": true }, "updated_at": { "title": "Updated at", "type": "string", "format": "date-time", "readOnly": true } } } } } } }, "tags": [ "candidates" ] }, "parameters": [] } }, "servers": [ { "url": "https://api.manatal.com/open/v3" } ], "components": { "requestBodies": { "candidates_createData": { "content": { "application/json": { "schema": { "required": [ "full_name" ], "type": "object", "properties": { "id": { "title": "ID", "type": "integer", "readOnly": true }, "external_id": { "title": "External id", "description": "Id of the candidate in the API consumer systems", "type": "string", "maxLength": 255, "nullable": true }, "full_name": { "title": "Full name", "description": "Full name of the candidate", "type": "string", "maxLength": 255, "minLength": 1 }, "creator": { "title": "Creator", "description": "User who created the candidate", "type": "integer", "readOnly": true }, "owner": { "title": "Owner", "description": "ID of the owner of the candidate - default to creator if none is provided", "type": "integer", "nullable": true }, "source_type": { "title": "Source type", "description": "Origin of the candidate", "type": "string", "enum": [ "sourced", "applied", "referred", "agency", "other" ] }, "source_other": { "title": "Source other", "description": "Field to add manual information to the source if the source_type is other", "type": "string", "maxLength": 255, "nullable": true }, "consent": { "title": "Consent", "description": "Whether the candidate gave permission to use his data (GDPR,Brazil's LGPD, USA´s CCPA ...)", "type": "boolean", "nullable": true }, "consent_date": { "title": "Consent date", "description": "Date at which the candidate gave his consent", "type": "string", "format": "date-time", "readOnly": true }, "picture": { "title": "Picture", "description": "Link to the candidate picture", "type": "string", "readOnly": true, "format": "uri" }, "email": { "title": "Email", "description": "Candidate email", "type": "string", "format": "email", "maxLength": 254, "nullable": true }, "resume": { "title": "Resume", "description": "Link to the candidate resume", "type": "string", "readOnly": true, "minLength": 1 }, "phone_number": { "title": "Phone number", "description": "Candidate phone number", "type": "string", "maxLength": 255, "nullable": true }, "gender": { "title": "Gender", "description": "Gender of the candidate", "type": "string", "enum": [ "male", "female", "other", "unknown" ], "nullable": true }, "birth_date": { "title": "Birth date", "description": "Candidate birth date", "type": "string", "format": "date", "nullable": true }, "address": { "title": "Address", "description": "Full address of the candidate", "type": "string", "maxLength": 255 }, "zipcode": { "title": "Zipcode", "description": "Code for the city of the address field", "type": "string", "maxLength": 255 }, "latest_degree": { "title": "Latest degree", "description": "Latest degree obtained by the candidate", "type": "string", "maxLength": 255, "nullable": true }, "latest_university": { "title": "Latest university", "description": "Latest university the candidate graduated from", "type": "string", "maxLength": 255, "nullable": true }, "current_company": { "title": "Current company", "description": "Company where the candidate currently works", "type": "string", "maxLength": 255, "nullable": true }, "current_department": { "title": "Current department", "description": "Department where the candidate works", "type": "string", "maxLength": 255, "nullable": true }, "current_position": { "title": "Current position", "description": "Position of the candidate at his current job", "type": "string", "maxLength": 255, "nullable": true }, "description": { "title": "Description", "description": "Description of the candidate - can only input text here.", "type": "string" }, "hash": { "title": "Hash", "description": "Unique hash of the candidate", "type": "string", "readOnly": true, "minLength": 1 }, "custom_fields": { "title": "Custom fields", "description": "Candidate values for custom fields defined in Manatal.", "type": "object" }, "created_at": { "title": "Created at", "description": "Date at which the candidate was created", "type": "string", "format": "date-time", "readOnly": true }, "updated_at": { "title": "Updated at", "type": "string", "format": "date-time", "readOnly": true } } } } }, "required": true } }, "securitySchemes": { "api_key": { "in": "header", "name": "Authorization", "x-default": "Token ", "type": "apiKey" } } }, "x-readme": { "explorer-enabled": true, "proxy-enabled": true, "samples-enabled": true } } ```