Talent network
Submit a candidate to the talent network
curl -X POST "https://external-api.paraform.com/api/external/v1/talent-network/candidates/submit" \
-H "Authorization: Bearer $PARAFORM_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"name": "string",
"linkedinUrl": "https://example.com",
"email": "jane@example.com",
"preferences": {
"locations": [
"new_york"
],
"workplaceTypes": [
"REMOTE"
],
"salaryMin": 0,
"idealFundingRounds": [
"PRE_SEED"
],
"visaAuthorization": "NO_VISA_AUTHORIZATION_NEEDED"
},
"resume": {
"contentBase64": "string"
}
}'
{
"accepted": true,
"deduplicated": true,
"batchId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"submissionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
Required scopes:
Rate limit:
Idempotency: send an
talent_network:writeRate limit:
write tier, 60 requests per minute per keyIdempotency: send an
Idempotency-Key header to retry safelydeduplicated is true only while an earlier submission of the same candidate is still queued or processing; once it reaches a terminal outcome, resubmitting starts a fresh attempt immediately. Optional recruiterEmail attributes the candidate to that agency member instead of the agency owner; because attribution is part of the dedupe key, a retry must resend the same recruiterEmail. Submissions are recorded with the EXTERNAL_API source. Each submission is tracked as a batch of one: poll GET /talent-network/batches/{batchId} for the per-item outcome. Requires Talent Network management to be enabled for your agency; without it the whole request answers 403.
Body
string
required
Constraints: min length 1.
string
required
Constraints: format
uri.string
required
Constraints: format
email.object
required
Show preferences properties
Show preferences properties
string[]
required
Constraints: min items 1.
Show 21 allowed values
Show 21 allowed values
new_york, san_francisco, south_bay_area, los_angeles, boston, seattle, texas, chicago, europe, latam, korea, canada, australia, india, uk, washington_dc, asia, denver, florida, minnesota, sacramentostring[]
required
Constraints: min items 1.
Allowed values:
REMOTE, ON_SITE, HYBRID.integer
required
Constraints: greater than 0.
integer | null
Constraints: greater than 0.
integer | null
Constraints: greater than 0.
string[]
required
Constraints: min items 1.
Allowed values:
PRE_SEED, SEED, SERIES_A, SERIES_B, SERIES_C, SERIES_D_PLUS, UNKNOWN.string
required
Allowed values:
NO_VISA_AUTHORIZATION_NEEDED, HAS_VISA_AUTHORIZATION, NEEDS_NEW_VISA_AUTHORIZATION.string[]
Show 83 allowed values
Show 83 allowed values
backend_engineer, frontend_engineer, full_stack_engineer, mobile_engineer, infrastructure_devops_sre, security_engineer, forward_deployed_engineer_solutions_support, robotics_software_engineer, robotics_platform_engineer, sales_solutions_engineer, qa_test_engineering, blockchain_protocol_engineer, developer_relations_advocacy, founding_engineer, product_engineer, embedded_firmware_engineer, mechanical_engineer, electrical_engineer, robotics_hardware_engineer, aerospace_flight_engineer, machine_learning_engineer, robotics_ml_engineer, data_engineer, data_science_analytics, computer_vision_engineer, research_scientist_applied_research, ai_ml_researcher, research_engineer_applied_research, data_scientist_applied_scientist, machine_learning_infrastructure, machine_learning_ops_platform, research_scientist, research_engineer, ai_engineer, product_management, product_design_ux_ui, brand_visual_design, marketing_growth, growth_engineer, growth_marketing, demand_generation, performance_paid_media, lifecycle_crm_email, seo_organic_growth, marketing_ops_analytics, product_marketing, customer_marketing, content_marketing, brand_marketing, social_media_influencer, communications_pr, events_field_marketing, marketing_leadership, founding_marketer_generalist, account_executives_sales, account_management_customer_success, business_development, sales_development_rep, customer_technical_support, content_copywriting, sales_gtm_leadership, partnerships, operations_strategy, robotics_operations_engineer, revenue_operations, finance_accounting, people_talent, chief_of_staff, program_project_management, executive_assistant, data_analyst, engineering_leadership, executive_leadership, clinical_healthcare, legal_compliance_officer, legal_operations, legal_compliance, legal_partner, legal_counsel, legal_associate, legal_in_house_counsel, legal_paralegal, legal_adminstring[]
Show 39 allowed values
Show 39 allowed values
venture_capital, logistics, real_estate, marketplace, healthcare, life_sciences, hardware, ai, gaming, fintech, finance, education, ecommerce, devtools, defense, cybersecurity, crypto, data, enterprise, financial_services, government, insurance, law, marketing, media, transportation, environment, robotics, security, construction, manufacturing, consumer, ad_tech, b2b, api_sdk, software_development, creator_economy, edtech, autonomous_vehiclesstring[]
Allowed values:
< 10 employees, 10 - 50 employees, 50 - 200 employees, 200 - 1000 employees, > 1000 employees.string
Constraints: format
uri.string
Constraints: format
email, max length 320.object
required
Response
boolean
required
Allowed values:
true.boolean
required
string
required
Constraints: format
uuid.string
required
Constraints: format
uuid.curl -X POST "https://external-api.paraform.com/api/external/v1/talent-network/candidates/submit" \
-H "Authorization: Bearer $PARAFORM_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"name": "string",
"linkedinUrl": "https://example.com",
"email": "jane@example.com",
"preferences": {
"locations": [
"new_york"
],
"workplaceTypes": [
"REMOTE"
],
"salaryMin": 0,
"idealFundingRounds": [
"PRE_SEED"
],
"visaAuthorization": "NO_VISA_AUTHORIZATION_NEEDED"
},
"resume": {
"contentBase64": "string"
}
}'
{
"accepted": true,
"deduplicated": true,
"batchId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"submissionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
⌘I
curl -X POST "https://external-api.paraform.com/api/external/v1/talent-network/candidates/submit" \
-H "Authorization: Bearer $PARAFORM_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"name": "string",
"linkedinUrl": "https://example.com",
"email": "jane@example.com",
"preferences": {
"locations": [
"new_york"
],
"workplaceTypes": [
"REMOTE"
],
"salaryMin": 0,
"idealFundingRounds": [
"PRE_SEED"
],
"visaAuthorization": "NO_VISA_AUTHORIZATION_NEEDED"
},
"resume": {
"contentBase64": "string"
}
}'
{
"accepted": true,
"deduplicated": true,
"batchId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"submissionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}